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Warranty 


CIPRICO, for the effective period set out below, warrants 
that its standard products sold hereunder will be free 
from defects in workmanship or material under normal 
use and service. CIPRICO's obligation under this 
warranty shall not arise until Buyer returns the defective 
product, freight prepaid, to CIPRICO. The only 
responsibilities of CIPRICO under this warranty are at its 
option to replace or repair, without charge, any defective 
component of such products. 

CIPRICO warrants that Software and Firmware supplied 
hereunder shall conform to the then current published 
documentation applicable to such programs. CIPRICO, 
for the effective period of the warranty set out below, will 
upon written notice from the Buyer documenting the 
symptoms or the defect, expend its best efforts to resolve 
software bugs and/or faults. This service shall be without 
extra charge, and at CIPRICO's option may include 
on-site visit(s) if in its opinion the conditions justify such 
visit(s). 

One year from date of delivery. 


Hardware 


Software 
and Firmware 


Effective Period 
of Warranty 


CIPRICO, for a period of 90 days, warrants that its Repaired or 

standard products repaired or replaced hereunder shall Replacement Product 

be free from defects in workmanship or material under (Out of Warranty) 

normal use and service. CIPRICO's obligations under this 

warranty shall not arise until Buyer returns the defective 

product, freight prepaid, to CIPRICO. The 

responsibilities of CIPRICO under this warranty are at its 

option to repair or replace, without charge, any defective 

component part of such products. 
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WARRANTY 


Any repair or 
replacement shall not 
extend the period 
within which the 
warranty can be 
asserted. 


This warranty does not extend to and shall not apply to: 

1 . Products which have been repaired or altered by other than 
CIPRICO, unless Buyer has properly altered or repaired 
the products in accordance with procedures previously 
approved, in writing, by CIPRICO; or 

2. Products which have been subject to misuse, neglect, 
accident or improper installation; or 

3. Products not manufactured by CIPRICO. 

The foregoing warranty and remedies are exclusive 
and are made expressly in lieu of all other warranties 
expressed or implied, either in fact or by operation of 
law, statutory or otherwise, including warranties of 
merchantability and fitness for use. CIPRICO neither 
assumes nor authorizes any other person to assume 
for it any other liability in connection with the sale, 
installation or use of its products, and CIPRICO 
makes no warranty whatsoever for products not 
manufactured by CIPRICO or with respect to any 
non-standard products which have been subjected to 
misuse, neglect, accident, or have been modified by 
the buyer. CIPRICO shall have no liability for 
incidental or consequential damages of any kind 
arising out of the sale, installation, or use of its 
products. 


Rimfire 3570 User’s Guide 
ii 





SERVICE POLICY 


A. “Out of warranty” repairs will be accomplished 
expeditiously at published rates plus shipping charges. 
Contact your appropriate Domestic or International Sales 
Administrator for current pricing. 

B. All products “in” or “out of warranty” returned for repair 
that are found to have no defect will be charged at the “out 
of warranty” rate. 

C. Shipments arriving at CIPRICO without a Return Material 
Authorization (RM A) number will not be accepted and will 
be returned to the customer, freight collect, regardless of 
warranty status. 

Upon determining that repair is required the Customer 
must: 


DOMESTIC CUSTOMERS 


Call CIPRICO Customer Support at (612) 559-2034 for an 
RMA number. 


INTERNATIONAL CUSTOMERS: 


Fax requests to the attention of Int’l Sales Administrator at 
612-559-8799 for an RMA number . 


SERVICE 

POLICY 


RETURN 

PROCEDURES 
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SERVICE POLICY 


m 


Please have the following information available: 

a) The serial number of the board(s). 

b) An open P.O. number with appropriate repair charge. 
Requirement applicable also for “no charge” warranty 
repairs. 

c) The reason for the return, or repairs needed. 

d) State if Debit/Rebill is applicable. 

SHIPMENT DOMESTIC CUSTOMER 

INSTRUCTIONS 

Ship prepaid to: 

CIPRICOINC. 

2800 Campus Drive 
Suite 110 

Plymouth, MN 55441 

INTERNATIONAL CUSTOMERS 

Ship prepaid to: 

MINNEAPOLIS-ST. PAUL 
INTERNATIONAL AIRPORT U.S.A. 

Consigned to: 

CIPRICO INC. 

c/o William Griffin & Company 
7830 12th Ave. So. 

Minneapolis, MN 55425 

Include with shipment: 

a) 1 ORIGINAL commercial invoice + 3 copies 

b) 1 ORIGINAL packing list + 1 copy (list S/Ns) 
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SERVICE POLICY 


Commercial Invoice must show: 

• Complete name and address of the manufacturer. 

• Complete name and address of the reseller. 

• Detailed, useful and adequate description of the 
merchandise including: 

Model # and name by -which each item is known. 

Box markings. 

Quantities in appropriate weights & measure. 

Value of each item in the currency of purchase. 

All additional charges outside ofF. O.B. value. 

Country of origin. 

Appropriate 8 digit HTS (tariff) number. 

The RMA number is valid for 30 days after issue. 

Upon completion of the services required, an invoice will 
be issued stating charges (when applicable) and work 
completed. 

Ciprico will prepay International return shipments (air 
freight consolidation) if the item was under warranty. All 
other shipments will be made freight collect. 


NOTE 


RMA NUMBERS 
INVOICING 

RETURN 

SHIPMENTS 
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Preface 

This manual is intended to instruct you on how to install Introduction 

and use the Rimfire® 3570 (RF3570) adapter. The adapter 

is essentially compatible with the Ciprico® RF3500 series 

of adapters. Therefore, at its simplest, this manual will 

instruct you how to install an RF3570 adapter to replace 

an existing RF3500 series adapter. Depending on your 

prior RF3500 implementation, this may require no change 

to your existing installed driver. 

Since there are more features added to the RF3570, this 
manual also provides the information necessary to change 
or write a new board driver to take advantage of the 
advanced operation possible with this adapter. 

There are two levels to the information provided in this Organization 

manual: 

• Reference 

• Practical Usage 

Chapters 3, 5, and 6 along with Appendices A and B are 
beneficial when you wish to find specific information 
about board jumpers, commands, error codes, or 
installation. They are meant to be used for reference. 

Other chapters — 2, 4 and 7 plus parts of 3 and 5 — are 
effective in a different manner. These chapters explain 
processes or features of the board in terms of examples. It 
is to these chapters that you should turn when you wish 
to find insights into usage of the board or a feature. 

A brief description of each section of the manual follows: 
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Chapter 1 : Product 
Overview 

Chapter 2: Hardware 
Essentials 


Chapter 3: Hardware 
Installation 


Chapter 4: Command 
Operation 

Chapter 5: SCSI 
Pass-through Commands 


Chapter 6: Board-control 
Commands Reference 


Chapter 7: Details of 
Usage 

Appendix A: Error Codes 


Appendix B: Cables and 
Connectors 

Appendix C: Specifications 


Appendix D: Defaults 


Conventions 

Notational 


Preface 


Provides a topside view of the RF3570, intending to orient 
you to the product as a whole. 

Explains, in text and illustration, the basic structure of the 
RF3570 hardware; port addresses and usage. 

Takes a practical approach to physically installing the 
RF3570 into a VMEbus system and attaching SCSI 
peripherals. 

Explains the command structures you will use and how to 
issue a command. 

Describes the Parameter Block structure you should use 
for SCSI Pass-through commands. These are commands 
that manipulate a device on the SCSI bus. 

A look-up reference for Board-control commands. These 
are commands that are interpreted by the adapter to affect 
its operation; they are used to tailor board operation for 
specific systems and applications. 

Explains in detail how and why to use some of the 
features of the RF3570 adapter. 

Lists the error codes returned in the Error field of the 
Status Block and also the codes returned in the Status Port. 

Provides pin-outs of connectors and specifies maximum 
cable length. 

Describes the physical and electrical characteristics of the 
board. 

Provides default values used by the RF3570: jumpers, 
hardware ports and command. 

This manual incorporates the following conventions: 

1 . An upper case letter H following a number indicates the 
number is a hexadecimal value (e.g., 32 = 20H and 

255 = FFH). 

2. In this document, a byte is defined as an 8-bit quantity, a 
word as a 16-bit quantity, and a double word as a 32-bit 
quantity. 
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Preface 


3. This manual represents all memory ordering in the Mo- 
torola format. This means that the least significant byte of 
a double word is placed in the most significant memory 
location. For a further discussion of memory ordering and 
information to use Intel ordering, see Chapter 7. 

In order to explain the command structures used by the Graphic 

RF3570, to describe the breakdown of the structure into 
fields, (double-word, word, and byte wide) this manual 
represents the structures and fields graphically, as they 
would be placed in memory. 

Throughout the RF3570 User's Guide you will find 
structures graphically represented similar to Figure P-1. 


The shaded grey areas of the structure provide a reference 
for the position of the components of the structure (the 
white fields) in memory. 


Address 
Offset, 
added to 
the 

Starting 

Memory 

Address 

of the 
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determines 

the 

double 
word 
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Figure P-1 : Graphic Representation of Parameter Block 


Byte 
Memory 
Address 
displays the 
ordering of 
byte-wiae 
fields in 
memory. 


Offset + x 
is the value 
to add to 
the Address 
Offset to 
determine 
byte 

boundaries. 


Address Offset 


The grey-shaded area on the left is named Address Offset. 
Since the structures are double-word wide, these 
hexidecimal values, added to the Starting Memory 
Address, reference the beginning of each double word in 
the structure. 


Byte Memory Address 

The grey-shaded area at the top of the graphic is the Byte 
Memory Address. Each of the four Offset + x fields 
describe the relationship of byte fields to the Address 
Offset. 
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Preface 


These documents apply to the Ciprico Rimfire 3570 SCSI 
host bus adapter. They may be of interest to you: 

VMEbus Specification Manual, Revision C.l (Motorola 
Publication) 

American National Standard: Small Computer System 
Interface (SCSI-1) Standard, (ANSI X3.131, 1986) 

American National Standard: Common Command Set, ANSI 
X3 Working Committee Document, X3t9.2/85-52 Rev.4A 

Draft Proposed American National Standard: Small Computer 
System Interface-2 , (ANSI X3.131, 199X) 

User manuals for applicable SCSI devices. 
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Chapter 1 — Product Overview 


This chapter provides an overview of the RF3570 product Introduction 

and it is intended to orient you to the product as a whole, 
before focusing on specific areas in the chapters that 
follow. 

In this chapter you will find information about: Su miTiary 

• Features of the design. 

• Where to find additional information. 

This chapter is most valuable to someone who wishes to 
find out general information about the RF3570 product. 
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□ 


About the RF3570 
Design 


Characteristics 


Features 


Product Overview 


With the introduction of the RF3570, Ciprico has added to 
the new generation of VME/SCSI adapters that began 
with the RF3560. The RF3560 and RF3570 adapters 
smoothly coordinate two separate bus structures — VME 
and SCSI. 

The VME bus is a commonly used system bus for host 
computers. The SCSI bus provides a standard interface for 
a variety of peripheral devices, such as disk and tape 
drives, and is flexible enough to also support other 
devices such as printers, scanners, and optical disk drives. 

As the SCSI standard has evolved, peripherals that 
support the Fast SCSI-2 specification have become 
available. The RF3570 also integrates the Fast SCSI-2 
specification and was designed to take advantage of the 
higher performance offered by the Fast SCSI-2 peripherals. 

The RF3570 shares the design goals of the RF3560 in that it 
strictly adheres to the bus protocols required by the SCSI 
and VME standards. Like the RF3560, the RF3570 is an 
easy-to-integrate design. 

The RF3570 uses the same architicture as the RF3560. The 
RF3570 uses a command interface to fetch new commands 
in parallel with data transfers. This allows the adapter to 
preprocess a command during a data transfer, in effect 
speeding up every transaction the host initiates with the 
RF3570 adapter. 

Thus, the RF3570 is plug-compatible with the Ciprico 
RF3560 product. However the RF3570 offers an 
enhancement to the RF3560. The RF3570 uses the Emulex 
Fast SCSI controller chip. Adhering to the SCSI-2 
standard, this chip supports Fast SCSI transfers up to 10 
MB/s. With it, the RF3570 handles commands on the 
SCSI bus faster for greater efficiency and overall 
performance. 

These are the features offered by the RF3570 design: 

SCSI Port 

• Supports up to 56 peripheral devices (7 targets with 
8 logical units each). 
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Supports Fast SCSI-2: Asynchronous 8-bit data rates 
up to 7 MB/sec. — Synchronous 8-bit data rates up 
to 10 MB/sec. 

Supports full SCSI-2 command set. Common 
Command Set (CCS) of SCSI, and command 
pass-through for other SCSI commands. 

Performs overlapped SCSI operations using 
discoimect/reconnect. 

Supports tagged, queued commands allowing 
multiple, simultaneous commands to be sent to a 
SCSI-2 target. 

Allows you to select up to 16 unique Sense Bytes (of 
256 returned) to receive as status data. 

Jumper selectable SCSI Bus reset on power-up and 
adapter reset. 

Jumper selectable board SCSI ID on power-up and 
adapter reset. 

Socketed SCSI bus termination power fuse with 
status and proper termination report. 


VMEbus 


Sustained VMEbus transfer rates at SCSI bus speed. 

Burst VMEbus capability of 20 MB/sec. , or 30 
MB/sec using block mode transfers, assuming 
minimum memory response time of 30ns. 

Supports 16, 24, or 32 bit VMEbus addressing with 
no addressing restrictions. 

Compatible with Revision C.l of the VMEbus 
specification. 


Host Interface 

• No timing restrictions on processing simultaneous 
host commands. 

• Supports a command list for faster command 1/ O. 

• Hardware byte and word swapping allows support 
of Intel i86. Motorola 68K, and National 32000 
families on the VMEbus. 

• Additional VMEbus Command Memory Interface. 
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E 

What next ? 


Product Overview 


Depending on what you wish to do next, you should turn 
to one of the following chapters: 

To learn more about the RF3570 hardware 

— Continue to Chapter 2. 

To learn more about the Installation process 

— Go to Chapter 3. 

To learn more about the Command Operation 

— Go to Chapter 4. 

To learn more about SCSI Pass-through commands 

— Go to Chapter 5. 

To learn more about the Board-control commands 

— Goto Chapter 6. 

To learn more about usage 

— Go to Chapter 7. 
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Chapter 2 — Hardware Essentials 

This chapter explains, in text and illustrations, the basic Introduction 

structure of the RF3570 hardware and is provided to assist 
you with installing and communicating with the board. 

In this chapter you will learn more about: Su mmary 

• Structure of the hardware based on the VLSI used. 

• Hardware ports used to begin communication to the 
board. 

This chapter is useful for anyone wishing to know what 
technology was used to design the KF3570 and 
understand the usage of the product. 
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0 


Hardware 
Structure and 
Description 


Intel 

80186 


Emulex 
Fast SCSI 


Short Burst 
FIFO 


Pipelined System 
Interface 
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The R3570 hardware design takes advantage of the 
capabilities designed into four VLSI chips: 

• Intel 80186 microprocessor 

• Emulex Fast SCSI Controller chip 

• Ciprico Short Burst FIFO (SBF) 

• Ciprico Pipelined System Interface (PSI) 
Additionally, the RF3570 design incorporates: 

• A new method of command fetching through a 
VMEbus Command-Memory Interface 

At the core of the KF3570 design is the 80186 supervisory 
microprocessor. The 80186 is well suited to the task of 
overseeing board operations; it uses optimized instruction 
encoding for high performance and memory efficiency. 
RF3570 performance is further boosted by using the 16 
Mhz version of the 80186. 

SCSI bus protocol for the RF3570 is efficiently handled by 
the Emulex Fast SCSI chip. Additionally, the Emulex chip 
provides the capability for the RF3570 to negotiate for Fast 
Synchronous transfers across the bus, up to 10 MB/ s. The 
Emulex Fast SCSI chip is a registered device that can be 
set-up for automated bus operations. These options are 
available to you via the Board-control commands 
discussed in Chapter 6. 

Ciprico's Short Burst FIFO (SBF) is part of the Direct 
Memory Access (DMA) structure for the RF3570. The SBF 
works in conjunction with Ciprico's Pipelined System 
Interface (PSI, discussed next) to provide a high-speed 
method for data transfer. The SBF provides high-speed 32 
byte buffered access to the system data bus. It also 
contains the address and status port registers discussed 
later in this section. 

Ciprico created the custom VLSI Pipelined System 
Interface (PSI) to work in conjunction with the SBF as a 
high-speed DMA channel. The PSI coordinates access to 
the system address bus; it has registers for the DMA 
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address count and transfer count. Also contained in the 
chip are the Channel Attention port register and the 
Interrupt Request level register. 

In addition to the VLSI hardware just described, the 
KF3570 has a VMEbus Command-Memory Interface. With 
this additional hardware, the supervisory 80186 
microprocessor is able to directly read and write system 
memory with command/status information without 
using the DMA path. This allows a new command to be 
fetched while a data transfer for a current command is 
executed. This method of parallel DMA and 
command-fetching boosts performance while being 
invisible to the user. 


Figure 2-1, on the next page, is a block diagram of the 
RF3570; it illustrates the hardware just described. The 
High Speed VME Bus DMA block includes the SBF and 
PSI. The VME Bus Interrupt Generator block is also part 
of the PSI. 


2 


Command 

Interface 


Block Diagram 
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Figure 2-1 : Block Diagram of RF3570 
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The Board Address and Slave Address Modifier to which Board Addressing 

the KF3570 responds on the VMEbus are set with jumpers 
on the board. 

The RF3570 adapter is an A16 SLAVE device on the Choosing an 

VMEbus. In keeping with VMEbus Specifications, the Address Modifier 

Address Modifier for selection of this type of device can 

be either 29H or 2DH. Since there is only one bit 

difference between the two values, a single jumper is 

provided to select an Address Modifier. 


AM5 

AM4 

AM3 

MlilMlI 

AMI 

AMO 1 

1 

0 

1 

ilwnper 

fl»*0 

llltliill 

0 

1 

| VMEbus Address Modifier Lines 


Figure 2-2: Choosing an Address Modifier 


Choose Address Modifier 2DH by removing the jumper, 
when you wish to reserve the RF3570 registers for short 
supervisory access. Choose 29H by inserting the jumper, if 
you wish to allow short non-privileged access: 



Address 1 

BE 

Fier 

Function 



D 

3 

2 


0 

2D 

1 

D 

1 

D 

n 

1 

Short Supervisory Access 

29 


D 

1 

0 

D 

1 

Short Non-Privileged Access 


Table 2-1: VMEbus Address Modifiers for RF3560 


The factory setting for the RF3570 Slave Address Modifier 
is 2DH; the jumper is out. 

The location and setting of this jumper is described in 
Chapter 3. 
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Choosing a With the address jumpers on the RF3570 board, you set 
VMEbus Address the upper 7 bits of the Board Address. This effectively 

reserves 512 bytes of VMEbus 16- bit address space. 
Within the reserved area, the RF3570 adapter has four 
register ports that are the foundation of its 
communication scheme. 



The factory setting for the RF3570 VMEbus Address is to 
jumper A12 making the default base address EEOOH. 
Details about the location and setting of the jumpers can 
be found in Chapter 3, Hardware Installation. 

Hardware Ports: There are four ports that are used to communicate with 

General the RF3570 adapter: Address Buffer Port; Channel 

Attention Port; Status Port; and Reset Port. The address 
and function of each port is described in this section. 

Hardware Port Each of the Hardware ports can be addressed as an offset 
Addresses from the base address, set with jumpers on the board. 

Further, all ports can be accessed in 16-bit mode. To 
address a specific port you must add the correct offset to 
the base address value. The offset values for the RF3570 
hardware ports are described in Figure 2- 4. 
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Example Port Addresses 

Using the factory set Base Address for the RF3570, EEOOH, 
the Hardware Port Addresses would be: 

Address Port = EEOOH 
Channel Attention Port = EE08H 
Status Port = EE10H 
Reset Port = EE18H 

Figure 2-4 also indicates how each port can be accessed by 
the Host: read or write. 

An overview of the operation of all of the Hardware Ports Overview 
is provided next. The overview is followed by a detailed of the Ports 
description of each Hardware Port that focuses on the 
rules of operation. 


Address Buffer Port 

This port is instrumental in setting up the RF3570 adapter 
I/O operation. With it you can do two things: 

1 . ) Set system bus transfer characteristics such as bus width 

and byte/word swapping for subsequent operations. 

Usually this is done only with the first command sent to 
the board, when you are initializing the board for opera- 
tion in your system. 

2. ) Pass the address of a Single Command Structure to the 

adapter. Any time you wish to issue a Single Command, 
you must use the Address Buffer Port to pass the address 
structure. Most often, the first Single Command executed 
contains a command to Start Command List. This function 
of the port is only used when issuing a Single Command. 

Channel Attention Port 

The Channel Attention Port is your means of informing 
the RF3570 adapter that a command is ready to be 
executed. The value you write to this port tells the adapter 
what kind of Command Structure to expect. Before you 
write to the Channel Attention Port you must set-up the 
appropriate Command Structure in the system memory 
space you will be directing the adapter to read. 
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B 


Status Port 

This port is used to read status from the adapter. There 
are two types of status that can be read: General Status — 
returned after a command completes during normal 
operation; and Reset Status — returned during board 
self-test at reset or power-up. 

Reset Port 

With the Reset Port you are able to initiate, through 
software, a reset identical to a hardware reset. 


Address Buffer The Address Buffer Port is a write-only port. It is used 

Port when you wish to execute a command using a Single 

Command Structure. It is loaded with: the starting system 
address of the structure; an address modifier value to be 
used when reading the Parameter Block contained in the 
structure; and a byte of control information through 
which you may instruct the RF3570 adapter about 
subsequent operation. 

The Address Buffer Port register is three words deep and 
16 bits wide. To pass all three words requires three writes 
to the port: 

• The first write must contain the Control byte and 
Address Modifier. 

• The second write contains the Most Significant Word 
(MSW) of the Single Command Structure address in 
system memory. 

• The last write contains the Least Significant Word 
(LSW) of the Single Command Structure address. 

The order of these writes is illustrated in Figure 2-5: 





11—1 

Control 

AM Bits for SCS j 


Single Command Structure Address: MSW 

3rd Write 

Single Command Structure Address: LSW 


Figure 2-5:Address Buffer Port Writes 
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A description of each of the fields of the Address Buffer 
Port follows. 

Address Modifier Field 

The Address Modifier (AM) Field of the Address Buffer 
Port is used to specify the Address Modifier value that the 
RF3570 adapter should use when reading the first 
Parameter Block. 

Control Field 


Use this byte-wide field to tailor the RF3570 adapter's use 
of the system bus. With it, you can set-up the adapter to: 

• transfer data in 16-bit or 32-bit mode on the VMEbus. 

• byte or word swap command structures to be 
compatible with the byte and word ordering of either 
Intel or Motorola architectures. 

• byte or word swap data to change the data byte 
ordering. 

Byte and word swapping are further discussed in Chapter 
7, Details of Usage. 

The bit meanings of the Control Field are as follows: 



For any of the control bits to be considered valid by the adapter, NOTE: 
the SET bit must be one. 


BSC Byte Swapping Control: 

Defines whether high and low bytes of a 
word will be swapped during transfer of 
status and parameter blocks. 

0 No swapping. 

1 <=» Change byte order. 
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WSC Word Swapping Control: 

Defines whether high and low words of a double 
word will be swapped during transfer of status 
and parameter blocks. 

0 ^ No swapping. 

1 Change word order. 

WID WIDth of data transfers: 

Determines whether data transfers across the 
system bus will be 16-bit or 32-bit wide 

0 ^ 16-bit data transfers. 

1 32-bit data transfers. 

BSD Byte Swap Data 

Determines whether high and low bytes of a word 
will be swapped during data transfer. 

0 ^ byte order not changed. 

1 ^ bytes swapped during transfer. 

WSD Word Swap Data 

Defines whether high and low words of a double 
word are swapped during data transfer. 

0 word order not changed. 

1 words swapped during transfer. 

SET select new control SETtings 

Determines whether the rest of the bits in the 
Control Field should be applied to adapter 
operation. 

0 ^ ignore all other bits. 

1 ^ apply bit values to next transfer. 

Determining a Control Field value 

These are the significant points to remember when 
determining the value you should use for the Control 
Field: 

• The Control Field value is meant to be set once, 
usually during system initialization. Generally, its 
value will be set with the first command issued to the 
board. 

• The values you choose for the Control Field will be 
applied immediately. They will be applicable for the 
next parameter block read in and all Future system 
memory accesses. 
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• The Control Field value is not ever applied to the 
Address Buffer Port or any of the other hardware 
ports. Always follow the format given in this section 
when accessing the hardware ports. 

• Attempting to change the Control Field setting after 
the RF3570 adapter has begun executing a command 
list will cause unexpected results. 

• The default value for the Control Field is zero; the 
adapter will operate in 16-bit mode with Motorola 
ordering of bytes and words during data transfers 
and the parameter and status block structures will 
not be swapped. 

Using the Byte and Word Swap controls with data transfers 

There are some guidelines for you to observe when using 
the byte and word swapping capabilities of the RF3570 
adapter: 

1 ,) If you enable byte-swapping, you must be sure that all 
system addresses and transfer counts that you use are 
aligned to a word boundary. Otherwise the byte swap 
setting will be ignored. 


2.) If you enable word-swapping, you must align all your 
system addresses and transfer counts to a double word 
boundary. Otherwise the word swap setting will be ig- 
nored. 


Single Command Structure Address Fields 

The Address Buffer Port is loaded with these two words 
to communicate to the RF3570 adapter the address of the 
Single Command Structure containing the command to be 
issued to the board. 

The Address Buffer Port is only used when issuing a 
Single Command to the RF3570 adapter. 
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The Channel Attention Port is a write-only port. It is used 
to direct the RF3570 adapter to execute Parameter Block(s) 
associated with a Command Structure you have already 
built in system memory. The Channel Attention Port is 
used for both Single and Command List issue. It is written 
slightly differently in each case though. 

Single Command Channel Attention 

To initiate execution of a Single Command you must do 
the following: 

1. ) Construct a Single Command Structure in system 

memory. 

2. ) Load the Address Buffer Port with the Control Byte, 

Address Modifier and the address of the Single Com- 
mand Structure constructed in Step 1. 

3. ) Write a 0 to the Channel Attention Port, instructing 

the RF3570 adapter to execute the Parameter Block 
contained in the Single Command Structure. 

Use an offset of 8H from your Base Address when 
writing to the Channel Attention Port. 

Command List Channel Attention 

To execute commands via Command List, you must do 
the following: 

1 . ) Have an active Command List. (Command Lists are 

begun by issuing the Start Command List command 
via a Single Command Structure.) If you attempt to 
issue a command via Command List when there is 
not an active List, you will receive an error code of 
11H in the Status Port. 

2. ) Fill the next available Parameter Block in the Com- 

mand List with the command you wish to have exe- 
cuted. 

3. ) Adjust the Command List Parameter Block IN Index 

to indicate additional commands have been added. 
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4.) Write a 1 to the Channel Attention Port, instructing 
the KF3570 adapter to begin executing the Parameter 
Block(s) contained in the Command List structure. 

If you have multiple Parameter Blocks ready in the 
space allocated for Command List, you may issue 
separate Channel Attention writes or you may issue 
one for the entire group. 

Use an offset of 8H from your Base Address when 
writing to the Channel Attention Port. 

For more information about how to use the Command 
List Structure, see Chapter 4, Command Operation. 


| BIT | 

; 2 

1 

0 

0 

0 

TYP 


Figure 2-7: Channel Attention 


The Channel Attention Port is three bits wide with the Channel Attention 

following meaning: Port Format 


TYP Channel Attention Type 

Indicates the type of command being issued 
with a write to the Channel Attention Port. 

0 Single Command Issue. 

1 <=» Command List Issue. 
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The Status Port is a read-only port. It contains information 
regarding the condition of the board during 
power-up/ reset and during normal board operation. It is 
used to report: 

• A sequence of self-test codes while a reset is 
occurring. 

• An error code if self-test fails or a catastrophic error 
occurs during normal operation. 

• Readiness of the board for commands (RDY bit). 

• Readiness for a new Single Command (ENT bit). 

The Status Port is 16-bits wide. The bit meanings of the 
port will be different depending on whether the status is 
General information or Reset information; each has 
separate formats. Both types of format are described in 
this section. 

The RF3570 adapter performs a series of self-tests on reset 
or power-up. The Status Port is used by the RF3570 
adapter to indicate the progress of the self-test as it is 
occurring. At power-up or reset, the Status Port will have 
this format: 


lii 


ill 

III 

13 

jjjj 

111 

jjjj 

■1 

IH 

IS 

III 

5 

4 

HI 

Jill 

1 

111 

0 

Self-test Code (STC) 

RDY 

STC 


Figure 2-8: Status Port: Reset 


Upon power-up or reset the following sequence will occur: 

1 . Immediately after reset the entire Status Port will be ze- 
roed. 

2. Next, self-test begins and as it progresses, the Self-test 
Code fields are updated with the code of the test currently 
executing. 

3. The RDY bit is zero during self-test to indicate the board 
cannot accept any command. All other fields of the Port 
(except Self-test Code (STC) fields) also remain zero as 
long as self-test continues. 


Status Port 


Status Port: 
Reset Format 
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4. The RDY bit will change to one if the self-tests complete 
successfully. The self-tests take less than 1 second. If, after 
this time, the RDY bit is still zero, a self-test has failed. 

If a self-test fails, the RDY bit will remain zero and the code 
of the test that failed will remain in the Self-test Code fields 
of the Status Port 

5. After the RF3570 self-tests complete successfully, and the 
RDY bit is set to one, the Status Port format will change to 
the General format. 

Whenever the hoard is reset, the host operations should wait a 
minimum of one second before testing the RDY bit. If, after the 
delay the RDY bit is not set to one, the value in the Self-test 
Code field of the Status Port will indicate the failing test. The 
RF3570 will not accept commands if this occurs. 

The Status Port fields during power-up or reset, have 
these meanings: 

STC Self-test Code 

This bit works in conjunction with bits 2 
through 7, to indicate the self-test currently 
executing. 

RDY Ready 

This bit indicates when the adapter is ready 
to accept commands after a reset has 
completed. 

0 ^ No command can be accepted 

1 Ready to accept a command 

Self Self-test Code 

Test The values of these bits change as self-test 

Code progresses. After a hardware reset they are 

zero. As self-test begins and progresses, the 
values are updated to the code of the test 
currently executing. 

See next page for a table of Self-test Codes. 


E 


NOTE: 
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Status Port If one of the self-tests does not properly complete, its test 
Error Codes number will be left in the Self-test Code byte. The 
following table describes the test numbers: 


NOTE: 

Bit 1 of 
the 

Status 
Port is 
not set 
until the 
board is 
in a 
Ready 
condition. 


(HMI 

Description 

00H 

The onboard processor is not working; it cannot access firmware 
EPROM; cannot access the Status Port - problem with Short Burst 
FIFO or VMEbus data lines. 

04H 

Static RAM error. All words of static RAM are written with FFFFH, 
then zero. This test is not exhaustive. 

OCH 

Firmware checksum error. The calculated checksum for odd and even 
EPROMs does not match the value stored in EPROM. 

14H 

Short Burst FIFO cannot be accessed. SBF data could not be loaded or 
read back. 

1CH 

Channel Attention Port cannot be accessed, or interrupt won't clear. 

90H 

PSI Address/Counter registers not masked to WORD boundaries. 

94H 

PSI Address /Counter registers not masked to DWORD boundaries. 

98H 

Value Miscompare errors of PSI R/W registers in Manual Load mode. 

9CH 

Value Miscompare errors of PSI R/W registers in Auto Load mode. 

A8H 

SCSI termination power fuse is blown, but termination power is still 
present at the SCSI connector. 

ACH 

SCSI termination power fuse is blown and termination power is not 
available at the connector. 

BOH 

Value Miscompare error of Emulex Fast SCSI chip R/W registers. 

B4H 

Emulex Fast SCSI chip did not generate a reset interrupt. 

B8H 

Emulex Fast SCSI chip registers not zeroed after reset. 

BCH 

SCSI bus hung, waiting for reset from Emulex Fast SCSI chip. Could 
be cabling. 

COH 

Short Burst FIFO 32 Bytes transfer miscompare error. 

C4H 

Short Burst FIFO Local Ready of System Not Ready error. 

C8H 

Short Burst FIFO byte transfer miscompare error. 

CCH 

Short Burst FIFO Local Not Ready or System Ready error. jj 

E5H 

The onboard processor failed the accumulator test. j 

E8H 

The onboard processor failed the store instruction test | 

E9H 

The onboard processor failed the shift instruction test. | 

ECH 

The onboard processor failed the compare instruction test. i 

| EDH 

The onboard processor failed the jump instruction test. J 


Table 2-2: Status Port Error Codes 
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After the RF3570 self-tests have completed successfully 
and the RDY bit is set to one, the Status port is used to 
return general board information. The Status Port will 
have the following format: 


1 

111 

*>*:•*: 

14 

13 

11 

III 

ill 
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III 

7 1 

SwSSiS 
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III 
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D 

j Code 
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D 

D 




Figure 2-9: Status Port: General 


The meanings of the Status Port fields are as follows 
during normal operation: 


Status Port: 
General Format 


ENT Entered 

This bit is used to signal when a new Single 
Command may be issued to the adapter via 
a Channel Attention. The board is ready for 
another Single Command write to the 
Channel Attention Port each time this bit 
value toggles. It does not indicate that a 
command has completed, only that a new 
Single Command may be initiated. 

Initially this bit ^ 0 

After 1st Single Command Channel 

Attention & 1; 

After 2nd Single Command Channel 
Attention ^ 0; etc. 


NOTE: This bit does not toggle for Command 
List Channel Attentions. 

RDY Ready 

This bit indicates when the adapter is ready 
to accept commands after a reset has 
completed. During normal operation it should 
always he set to one. 

0 No command can be accepted. 

1 ^ Ready to accept a command. 

ERR Error 

This bit is used to signal that a catastrophic 
error occurred that could not be reported 
through the command interface. (Example: 
Using an invalid Parameter Block address 
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which resulted in a VMEbus error. Typically the 
AMBER LED will also light if this bit is set.) 

0 ^ Normal operation. 

1 *=> Error condition. 

Code Board Type or Error Code 

When the ERR bit is set to one, this byte will 
contain a catastrophic error code. If the ERR bit is 
zero, the code byte will contain the Ciprico board 
type. 

02 RF35XX board type. 

Other than 02 ^ Catastrophic Error Code. 


There are several catastrophic error codes: 






10H 

Bad PBIN Value 

The Command List PBIN (Parameter 
Block IN) value exceeded the value set 
for PBNUM (Parameter Block Number). 

11H 

State wrong for 
Start/Stop 
Command List 
command 

This code is returned under these 
conditions: 

Start Command List command issued 
when a command list is already active. 
Stop Command List command issued 
when no command list is presently 
active. 

Command List Channel Attention 
issued when no Command List is active. 

14H 

Software VMEbus 
Timeout 

The adapter times each of its VMEbus 
transfers; it will report this error if a 
VMEbus transfer takes too long to 
complete. This can occur for transfers of 
parameters as well as transfers of data. 

15H 

VMEbus Error 
Occurred 

A VMEbus error was detected while the 
adapter was transferring either 
parameters or data. 

96H 

Internal Firmware 
Error 

This error code indicates that a 
Firmware error was detected during the 
execution of a command. 


Table 2-3: Status Port Catastrophic Error Codes 


J 


To access the Status Port, use an offset of 10H from 
the base address of the adapter (which is set by 
jumpers on the board). 
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This is a write-only port. You may write to this port when 
you wish to initiate a board Reset. The write can consist of 
any value because the data is ignored. The result of this 
write will be a hardware reset. 

Whether or not the RF3570 adapter also resets the SCSI 
bus at this time is determined by how you set a jumper on 
the board. (Information about the configuration jumpers 
is in Chapter 3, Hardware Installation.) 

To access the Reset Port use an offset of 18H from the base 
address of the adapter (set by jumpers on the board). 

When a reset has completed with no self-test errors, the 
RDY bit of the Status Port will be set. 

The following describes port usage. Assume that the 
adapter address jumpers are set to a base address of 
EEOOH. 

Issuing a Reset — Write to Reset Port at address EE18H. 
The RF3570 will begin executing self-test. Read the Status 
Port at address EE10H to find when self-test completes. 

Issuing a Single Command — Write three words to 
Address Buffer Port at address EEOOH. These words select 
system bus width/ swapping options as well as the 
Address Modifier and memory address of the Single 
Command. To begin command execution, issue a Single 
Command Channel Attention by writing a 0 to Channel 
Attention Port at address EE08H. Read Status Port at 
EE10H to check for Enter condition before issuing the next 
command. 

Issuing a Command List — Once an active Command 
List has been established, write a 1 to the Channel 
Attention Port (address EE08H) for a Command List 
Channel Attention after the new commands are added to 
the list. 

Read Board Command Status — Read the Status Port at 
address EE10H to find the state of the adapter. 


HJ 


Reset Port 


Descriptions of 
Port Usage 
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Chapter 3 — Hardware Installation 

Unifying the parts of a system into a whole requires a Introduction 

smooth transition of the theoretical into the actual. This 

chapter takes a very practical approach to physically 

installing an RF3570 board into a VME-based system and 

attaching SCSI devices. 

In this chapter you will learn: Su mmary 

• The hardware installation process from unpacking to 
power-up. 

• What configuration changes to make. 

• What to look for in the documentation that comes 
with your SCSI device. 

This chapter is most helpful for someone who is 
responsible for making the hardware operational. 
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Overview of the 
Installation Process 


Hardware Installation 


There are only five steps involved in bringing your 
RF3570 adapter into functionality. Each is outlined briefly 
below and then in more detail on the following pages. 

Step 1: Unpack the board 

The RF3570 adapter is carefully packaged to prevent 
damage and exposure to static. You should observe 
precautions while unpacking. 

See page 3-4 for more information. 

Step 2: Set jumpers and termination on the board 

There are eight blocks of jumpers on the board. Three 
jumpers are factory set and should not be changed. You 
will need to know how to set the remaining five. These 
jumpers are for: default SCSI ID, default SCSI bus reset on 
power-up, enable SCSI parity-checking. Board VMEbus 
address and Address Modifier, SYSFAIL signal assertion. 
Exact Burst counter, and Bus Arbitration. 

You will also need to determine whether you will 
terminate the SCSI bus on the board. You will need to 
remove termination if the RF3570 adapter is not at the 
physical end of the SCSI bus cable. 

See page 3-6 for more information. 

Step 3: Insert the board into a VME slot 

You must select a VME slot and prepare it for the adapter 
by removing Bus Grant and Interrupt Acknowledge 
daisy-chain jumpers from the VMEbus backplane. There 
are many types of system enclosures that the KF3570 will 
fit into. 

See page 3-14 for more information. 
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Step 4: Apply power and observe LEDS 

The RF3570 adapter has a set of LEDs on its faceplate that 
will indicate its state on power-up. You should observe 
these LEDs and other indicators that are described in this 
section. If the LEDs indicate a problem, you may need to 
follow some of the troubleshooting hints also described. 

See page 3-16 for more information. 

Step 5: Configure and connect SCSI devices 

There are several types of SCSI devices that you may be 
attaching to the RF3570 adapter. Each requires set-up and 
each must be cabled to the SCSI bus. There are restrictions 
on the length of the bus cable and termination factors that 
must be considered. 

See page 3-18 for more information. 
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Step 1 : Unpacking 
the Board 


Shipping 

Damage 


Hardware Installation 


The RF3570 adapter is shipped to you in one box. You 
should find the following items included in the shipment: 

1 RF3570 adapter board 

1 Rimfire 3570 SCSI Host Bus Adapter User's Guide 


Immediately after receiving it you should check your 
shipment for evidence of damage or mishandling in 
transit. 

Ciprico's warranty does not cover shipping damages. 
Therefore, if the shipping carton is water stained or 
otherwise damaged, contact the carrier or shipping agent 
with information on the damage. 

For repair or replacement of any Ciprico product 
damaged in transit call Ciprico for return instructions and 
authorization. 
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Before you remove the RF3570 adapter from its box you Unpacking 

should observe precautions to prevent damage by static: the Board 

wear a wristband and strap while handling the adapter. 
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Step 2: Jumpers There are eight blocks of jumpers on the RF3570 board, 

and T erminatio ri Three of the blocks should remain factory set. You will 

need to consider each of the other five blocks to determine 
whether your application requires changes from the 
default settings. 


Factory 


The location of the blocks on the board are shown below: 



Each of the jumper blocks shown above will be discussed 
in the following pages. 


Factory-set These jumpers should be left as set by the Ciprico factory. 
Jumpers They are used by the technicians who test the board 

before shipping; if you change the setting of any of these 
jumpers the board will not work. 


SCSI Configuration 
Jumpers 


This block of jumpers is used to select power-up defaults 
for: 


• Adapter SCSI ID 

• SCSI Bus reset on power-up and system reset 

• SCSI Bus Parity 
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The jumper block is illustrated below: 



Figure 3-2: SCSI Configuration Jumper Block 


The default settings of the jumper block are shown in 
Figure 3-2 and Table 3-1. 


llligli 



1 -2 

Reserved 

OUT 

3-4 

OUT 


OUT 

7-8 

Enable SCSI Parity Checking 

OUT = Selected 

IWM 

SCSI bus Reset at Power-up 

OUT =Selected 

11-12 

SCSI ID Bit 2 

OUT = 0 

13-14 

SCSI ID Bit 1 

OUT = 0 

15-16 

SCSI ID Bit 0 

1 

OUT = 0 


Table 3-1: Default Jumper Settings 
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Bus Request/Grant This jumper block is used to select the level at which the 

Jumper RF3570 adapter can request and be granted access to the 
VMEbus by the ARBITER. The four sets of BUS/GNT 
signals are daisy-chained separately on the VMEbus 
backplane. Only one of the four levels can be used by a 
single REQUESTER The BUS/GNT signals that are not 
used are passed through to the next board on the 
backplane. The BUS/ GNT signal will be gated on the 
adapter for whichever level you choose. If the RF3570 
adapter has a request for the bus pending, it will take 
control of the VMEbus. If it has no request pending it will 
pass the BUS/GNT signal to the next board. The Bus 
Request/ Grant jumper block is illustrated below. 



The setting shown in Figure 3-3 is the default from the 
factory. It indicates level 3 for Bus Grant/Request. 


0 12 3 



To select a Request/ Grant level, place three jumpers 
down the level you wish to use. The unused levels should 
have jumpers placed from pin 4 to 5. 

Bus Request and Grant on Level 2 
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Bus Request and Grant on Level 1 


0 12 3 


■ 

■ 

• 

I 

■ 

■ ■ 
■ * 
■ ■ 

n 
■ ■ 


«JF 


Bus Request and Grant on Level 0 


0 12 3 


[ 

t 

t 

■ ■ 
■ ■ 
■ ■ 

III 

i a ■ 


—If 


The VMEbus Sysfail signal is (according to standards) to Sysfail 
be asserted during Power-on Self-test to indicate Self-test Jumper 
is occurring. Some systems instead interpret the signal as 
a failure. For this reason, the RF3570 adapter jumpers the 
signal on the board. 

IN Sysfail signal asserted on bus during 

Self-test. 

OUT Sysfail signal not asserted on bus. 

Figure 3-3 on the previous page illustrates the location of 
the Sysfail Jumper, underneath the Bus Request/Grant 
Jumpers. As shown, the default for this jumper is IN. 


With this jumper you can choose one of two ways for the 
RF3570 to perform DMA operations: 

IN This setting will minimize the number of 

times that the RF3570 arbitrates for control 
of the VMEbus. The adapter will not initiate 
a VMEbus DMA operation until ready to 
transfer a complete burst of data (based on 
the bus Throttle Count setting in the General 
Options command as described in Chapter 
6). The RF3570 will initiate a DMA transfer 
of less than a complete burst of data only 
when it is finishing a transfer that was not 
an even multiple of complete bursts. 


Exact Burst 
Jumper 
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OUT This setting usually provides the highest level of 
performance. In this mode the RF3570 will intitiate 
a VMEbus DMA operation as soon as it is ready to 
transfer any data. 


Default for this jumper is OUT. Refer to Figure 3-4 for 
location of this jumper block. 



VMEbus Address This set of jumpers is used to select the address at which 

Jumpers the RF3570 adapter can be addressed by the system. The 
jumpers set the upper 7 bits of the 16-bit address, thereby 
reserving 512 bytes of address space. 


Also available to be set is bit 2 of the address modifier 
lines. With this jumper in you can elect to have the RF3570 
adapter reserved for short supervisory access only. If the 
jumper is out, the board will be in short non-privileged 
access mode. 


The VMEbus Address jumpers are illustrated in Fig. 3-4. 

The default address setting of EEOOH, with address 
modifier of 2DH is shown. 


For the VMEbus Address Jumpers: 

IN Is equal to a 0 for that address bit. 
OUT Is equal to a 1 for that address bit. 
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E 

For the Address Modifier Jumper: 

IN Is equal to Address Modifier 29H. 

OUT Is equal to Address Modifier of 2DH. 

The VMEbus Address Jumper block pins correspond to 
the VMEbus address lines as follows: 




• 

# 

• 

• 

• 

• 

• 

• 

• 

• 

• 

• 

• 

• 

• 

• 

A15 

A14 

A13 

A12 

All 

A10 

A9 

AM2 


Below is a table of some common RF3570 Base Addresses. Example 
The table demonstrates the settings of the VMEbus Addresses 

Address Jumpers and the VMEbus Address Modifier 
Jumper for each of the addresses. 



ill 




— 



H§|Si 

lllltl 

AM 

lift! 

■ 

iPSS 

■ 


j/m 

mmhni 


Out 

Out 

Out 

In 

Out 

Out 

Out 

Out 

EE00H 

2DH 

Hi! 

Bill 


Mil 

lilill 

Out 

©St 

In 


IMM 

Out 

Out 

In 

In 

Out 

In 

Out 

Out 

CA00H 

2DH 

IMI 


Sffll 

|§ll 

1HII 

wmi 


lilill 

AOOOH 

ftiiM 

In 



Out 

In 

In 

In 

Out 

5000H 

2DH 

HI 

illlll 

11111 

llili 

in 

In 

■Mi 

illl 

HMMl 

iPiiMiii 

MBS 

In 

Out 

Out 

i 

Out 

Out 

Out 

Out 

3E00H 

2DH 

| 'In 

In 

si® 

WKB 


| o ■ 

In ' 

In | 

MSllll 


In 

In 

Out 

In 

Out 

In 

Out 

Out 

2A00H 

2DH |i 

1 to ’ 

lilill 

IS1M 

In 

Out 

MB 



2800 b 



Table 3-2: Example Base Address Jumper Settings 
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Each end of the SCSI bus cable must be terminated to 
prevent corruption of the data and control signals. The 
RF3570 adapter has terminator packs on the board. These 
are removable in the case that the adapter is not at the end 
of the SCSI cable. 

The adapter provides termination power on the SCSI bus 
cable. This line is fused on the board. The fuse is 
replaceable. 

The location of the terminators and removable 
termination power fuse are shown in the following 
illustrations. The number of terminators depends on 
whether the board is single-ended or differential. 

Figure 3-5 illustrates a single-ended board. 



Figure 3-5: Single-ended Board Fuse and Terminators 
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Figure 3-6 illustrates the terminators and fuse on a 
differential board. 



Figure 3-6: Terminators and Fuse on Differential Board 


Replacement Fuse 

In the event that the termination power fuse is blown, 
replace it with: 

Littlefuse P/N 273-01.5 or equivalent 

It is very important to replace the termination fuse with an NOTE: 

exact equivalent. If you replace the termination fuse with a 
value lower or higher, you risk continued problems or damage to 
the RF3570 and attached equipment. 
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Step 3: Board 
Insertion 


General Steps 


Hardware Installation 


Although the VMEbus Specification has very precise 
mechanical and electrical requirements for the subrack, it 
still leaves room for variance in the design of the system 
enclosure. You will need to examine the enclosure that 
you will be working with to determine how to get access 
to the subrack. 

In most cases you will need to follow these steps to insert 
the board: 

1 . Remove power from the system. 

2. Remove as much of the enclosure shell as is necessary to 
adequately access the VMEbus subrack. 

3. Choose a free double-height slot for the RF3570. 

4. Remove bus grant arbitration and interrupt acknowledge 
jumpers from backplane. You will need to remove the four 
Bus Grant jumpers, and the Interrupt Acknowledge daisy- 
chain jumper from the slot chosen for the RF3570. These 
jumpers must be installed only for slots that are empty. 

5. Align the RF3570 with the board guides on the subrack for 
the slot you have chosen. Be sure the orientation is correct. 
(If J1 on the subrack backplane is up, the component side 
of the board should face right.) 

6 . Slide the board forward and firmly press into the J1 and J2 
connectors on the backplane. You should feel it give 
slightly as you press inward. 

7. If your system subrack accommodates them, fasten the 
small screws on the RF3570 into the subrack. You will need 
a small flat bladed screwdriver. 

The illustration on the next page demonstrates insertion 
of the RF3570 into a VMEbus subrack. Do not reinstall the 
enclosure panels yet. You will need to observe the 
faceplate LEDs in the next step. 
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Step 4: Apply After you have inserted the board into the VMEbus slot, 

power and observe apply power to the system. 

LEDs 

There are two LEDs on the faceplate of the RF3570: one is 
green and the other is amber. 


Meaning The LED's are used in the following manner: 

Of LED’S 


• The green LED indicates BUSY status when the board 
is processing commands. 

• The amber LED indicates an ERROR status. 



Power-up At a normal power-up you should observe the following: 

Sequence 


1 . Both LEDs will briefly light, then the green will go out. 

2. The amber will stay lit for less than 1 second, while self-test 
is running. 

3. The amber LED will go out, indicating self-test has passed. 


Rimfire 3570 User’s Guide 
3-16 






Hardware Installation 



The amber LED is used to indicate an error condition. Error 

These are the conditions indicated by the amber LED: Conditions 

BLINKS 


This indicates that the adapter has had a 
self-test failure. 

STAYS ON SOLIDLY 

This indicates that the board has had a 
catastrophic error during operation such as 
bus error or timeout. The Status port will 
contain an error code that details the type of 
failure that occurred. These error codes are: 


| Cotfe 


Description Bill 

10H 

Bad PBIN Value 

The Command List PBIN (Parameter f 

Block IN) value exceeded the value set 
for PBNUM (Parameter Block Number). 

11H 

State wrong for 
Start/Stop 
Command List 
command 

This code is returned under these 
conditions: 

Start Command list command issued 
when a command list is already active. 
Stop Command list command issued 
when no command list is presently 
active. 

Command List Channel Attention 
issued when no Command List is active. 

14H 

Software VMEbus 
Timeout 

The adapter times each of its VMEbus 
transfers; it will report this error if a 
VMEbus transfer takes too long to 
complete. This can occur for transfers of 
parameters as well as transfers of data. 

15H 

VMEbus Error 
Occurred 

A VMEbus error was detected while the 
adapter was transferring either 
parameters or data. 

96H 

Internal Firmware 
Error 

This error code indicates that a 
Firmware error was detected during the 
execution of a command. 


Table 3-3: Status Port Catastrophic Error Codes 
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Step 5: Configure 
and Connect SCSI 
Devices 


Selectable 

Options 


Hardware Installation 


The RF3570 can communicate with any SCSI device that 
adheres to the SCSI Common Command Set. Each 
separate device on the SCSI bus must have a unique SCSI 
ID and be properly terminated. In addition, it may have a 
self-test sequence or options and parameters that you 
should know about. 

You will need to examine the documentation that arrives 
with your selected peripheral for more information. This 
section outlines what to look for. 

Each peripheral vendor can choose a unique way to 
assign a SCSI ID and enable /disable options. The two 
most common methods are: jumpers and switches. 

You will need to find the section in your peripheral 
documentation that explains how to set the options. 

SCSI ID 

You will need to decide which SCSI ID to assign to your 
peripheral(s). The higher SCSI ID's are given bus access 
priority. Each device on the SCSI bus (including the 
KF3570) must have a unique SCSI ID. The factory-set ID 
for the RF3570 adapter is zero. 

Options 

Your device may also have a means to select options such 
as: termination power source, automatic spin-up, or 
parity checking. 

Termination Power: If your hard disk is the last peripheral 
on the SCSI bus, it will need to have terminators installed. 
Some hard drives allow you to select whether the 
terminators will get power locally, on the drive, or use the 
5 volts available on the SCSI cable. Setting up the drive to 
provide it's own terminator power is the most universal 
solution. The RF3570 provides TERM PWR on the SCSI 
cable. 

Automatic Spin-up: Some disk drives allow you to delay 
spin-up of the disk media until a SCSI command is issued 
to spin it up. The advantage to this is that it cuts down the 
power draw when the system is initially turned on. 
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Parity Checking: The RF3570 is flexible enough to allow you 
to use SCSI bus parity checking or disable it. If you wish 
to use it, parity checking must be enabled on each 
peripheral and also using the General Options command 
explained in Chapter 6. Note that all devices on the SCSI 
bus must be setup for parity the same. 

You can select a power-up /reset default for parity 
checking with pins 7 and 8 of the SCSI Configuration 
Jumper Block. The value you use in the General Options 
command overrides the jumper setting, so you should be 
sure that they match. (You would install a jumper over 
the pins to disable parity checking.) The jumpers are 
further described on page 3-7. Moreover, you can use the 
Board Information Board-control command to discover 
the current setting of the parity jumper without removing 
the board. See Chapter 6 for more information on 
Board-control commands. 

The devices at each physical end of the SCSI bus cable Termination 

must have terminating resistors installed. If termination is 

not correctly applied to the bus, data corruption can 

occur. If you are using only two devices on the bus (the 

RF3570 and one peripheral) both must be terminated. If 

you are using multiple devices on the SCSI bus (several 

peripherals, in addition to the RF3570 adapter) only the 

two devices physically at the ends of the cable must be 

terminated. 

The SCSI cable connector for the RF3570 extends from the Cabling 
front faceplate. The type of cable you use and the 
connector used on the KF3570 depends on the model. 


Hpiilll 

illlMIiil 


SCSI Connector 

RF3573 

Single-ended 

6 meters (20 ft.) 

50 pin, ribbon 

RF3574 

Differential 

25 meters (82 ft.) 

50 pin, ribbon 

RF3575 

Single-ended 

6 meters (20 ft.) 

50 pin, high density 

RF3576 

Differential 

25 meters (82 ft.) 

50 pin, high density 
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Chapter 4 — Command Operation 


The purpose of this chapter is to provide you with a 
comprehensive view of the RF3570 firmware operation 
and how it works in concert with the hardware described 
in Chapter 2. By explaining the command structures you 
will use, and when to use them, this chapter teaches you 
how to use the board; it explains in broad terms what a 
board driver must do. 

This chapter discusses the following: 

• Format of the basic Parameter and Status blocks from 
which command structures are built. 

• Types of command structures — Single Command 
ana Command List. 

• The process for issuing a single command. 

• The process for creating and starting a command list. 

• Examples of issuing both types of command 
structures. 

• Implementation of the command structures within a 
'Coroutine. 

• Types of commands you can issue — SCSI Pass- 
through and adapter Board-control commands. 

• When to use each type of command. 

The explanations in this chapter would be most beneficial 
for someone designing a driver for the RF3570 adapter or 
attempting to understand one existent for the RF3500 
family. 


Introduction 


Summary 
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What the Adapter 
must accomplish 


Command Operation 


There are several basic operational requirements that the 
RF3570 adapter must fulfill: 

The Host must have a method to communicate details of 
command operation with the adapter — Communication 
from the host to the RF3570 adapter takes the form of 
command structures. There are two types of command 
structures you can use with the RF3570 adapter: Single 
Command and Command List. The latter is preferable in 
most situations because it boosts the performance of the 
adapter. There are instances when you must use the single 
command method of communication. Both types of 
structures are described in the following sections. 

The adapter must have a means to communicate the 
outcome of a command process — Reporting the 
completion status of the command is accomplished via 
status blocks which are part of the command structure. 
Just as there are two types of RF3570 command structures 
for you to use when issuing a command, there are two 
ways status structures are returned from the adapter. 
Each uses slightly different protocol to notify the Host of 
returned status. This is described in more detail in a later 
section. 

The Host must have a way to alter the behavior of the 
adapter to suit its environment — To meet the versatility 
required by differing host operating systems and 
application needs, the RF3570 adapter has a set of board 
level commands for you to use. These commands allow 
you to select options relating to the system bus of the host 
and also tailor operation for the devices attached to the 
board. They are referred to as Board-control commands. 

The Host must have a defined protocol for issuing a 
command to the device(s) attached to the adapter — The 
RF3570 adapter is an interface between the VMEbus and 
SCSI bus architectures. When the VMEbus Host requests 
an operation involving a SCSI device, the RF3570 issues a 
command to the device using the SCSI protocol. It uses 
the defined SCSI command structure within its own 
parameter-block command structure. This allows the 
KF3570 to pass the command to the SCSI device without 
modification. This type of command is called a 
Pass-through command. 
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The adapter must provide status from a device regarding 
the command just completed by the device — Just as the 
defined SCSI command structure is part of the RF3570 
command structure and is passed through to the device, 
the Sense Bytes from the SCSI device are reported to the 
host within the Status Block returned by the adapter. 


Each of these operational requirements are discussed in 
more detail on the following pages. 
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The Base The Parameter Block is one of the basic building blocks of 

Parameter Block the RF3570 command structures. It is designed to hold all 

facts relevant to a single command. 

The same Parameter Block format is used whether the 
command is a Pass-through command directed to a SCSI 
device, or a Board-control command to be interpreted 
and acted on by the adapter. (The various flags and byte 
values may have different meanings in each case though.) 

All Board-control commands are described in detail in 
Chapter 6. More information about how the RF3570 
implements SCSI commands can be found in Chapter 5. 
See a SCSI specification and vendor-supplied peripheral 
documentation for details about particular SCSI 
commands. 


Parameter Block 
Format 


The Parameter Block format for all SCSI Pass-through and 
also adapter Board-control commands is illustrated below: 


Address 

Byte Memory Address 

mmm 

Offset +G 

Offset + 1 



jiMl 

Command Identifier ] 

llllltll 




Target/ Adapter ID 

SBHI 

Command Options, Addresses, and Transfer Count 


lliM 





Hill 

Command 




iillll 


Command Descriptor Block 

— 1 







Figure 4-1 : Base Parameter Block 


A brief description of each of the fields follows: 

Command Identifier 

When setting up a command structure, you use this field 
to distinguish a command in order to associate it with a 
returned Status Block. The value is a double-word and 
must be unique; the Command Identifier for each 
currently executing command should be different. Any 
unique four-byte value will work. You could, for example, 
use the command address or a Parameter Block Index 
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pointer as the Command Identifier. Both SCSI 
Pass-through commands and adapter Board-control 
commands use this field for proper identification of status 
to be returned whether the command is issued in a Single 
Command structure or a Command List. 

Command Options, Addresses, and Transfer Count 

You will use these fields of the Parameter Block to supply 
an address and transfer count when a data transfer is 
required by the command you wish to issue. There are 
also some command-modifying options available to you 
depending on the command you are issuing. 

Target/Adapter ID 

The Target/ Adapter ID byte is very important to the 
command issue process. The value you supply here 
determines whether the command described in the 
Command Descriptor Block is a SCSI Pass-through 
command or an adapter Board-control command: 

• If the Target = FFH, the command is a Board-control 
commandT 

• If the Target = 0-7H, the command is destined for the 
SCSI target with that ID. 

Command Descriptor Block 

In this part of the Parameter Block you must supply a 
Command Code and details about how you want the 
command executed. Depending on the value you supply 
in the Target/ Adapter ID field, the Command Descriptor 
Block will contain a SCSI command, or an adapter Board- 
control command. The RF3570 Board-control commands 
are explained in detail in Chapter 6. You can find more 
information about issuing SCSI Pass-through commands 
later in this chapter and also in Chapter 5. For detail about 
the actual SCSI commands, see a SCSI specification or 
your vendor-supplied peripheral documentation. 

Command Code 

This field will always contain a command code for either 
a SCSI Pass-through or an adapter Board-control 
command. 
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The Base Status The Status Block is another of the building blocks of the 

Block command structures you will be using when issuing 

commands. Used in conjunction with the Parameter 
Block, its purpose is to report the outcome of a command 
you issued. 

The Status Block format is the same whether you have 
issued a SCSI Pass-through command or a Board-control 
command. It appears the same whether the command 
structure you used is a Single Command or a Command 
List, however there is a difference in the number of Status 
Blocks you may receive for each type of command 
structure. 


Single Command structures return only one Status Block. 
The Single Command structure will contain only the last 
Status Block — the Status Block with the CC (Command 
Complete) bit of the Hags byte set. 

When you are using a Command List structure, multiple 
Status Blocks for any one command are possible 
depending on the retry and Sense Byte selections you 
have made (with the Unit Options or Extended Unit 
Options Board-control commands). 


Status Block 
Format 


The Status Block Format you will see used for all returned 
status information is illustrated in Figure 4-2: 


The fields 
displayed in 
light type are 
the default 
Sense Bytes 
returned by 
SCSI 


Pass-through 

commands. 


Address 
! Offset 


111111111111 



MWHIMiiMl 

BMM 

Command 

Identifier || 

nflfl 

Reserved 

SCSI Status 

Error 

Flags 

[[Mill 

0 ss Ciass/Code 

Vtflsl n 

~ SCSI Flags 

3 = info Bytes 

II QCH I 4 -info Byte 

wwwl w&flSG 13 

B x info Byte 

jftes 

6 - info Byte 

7 - Ex Length 


Figure 4-2: Base Status Block 


Following is a brief description of each of the fields: 


Command Identifier 


This value will identify which Parameter Block has 
completed. 
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Flags 


This byte can be polled to determine whether, and in what 
condition, a command completed. It has this format: 


[ BITS 

7 

lllllll 

lllllll 

1111111 

lllllll 

1 if 

lllllllll 

■an 


ERR 

RTY 

DTT 

0 

CSB 

0 

IMi 


Figure 4-3: Bit-meanings of Flags Field 


CSB Continued Status Block 

This bit indicates that the current Status 
Block is one of several Status Blocks 
generated because extended Sense Bytes are 
enabled. Only valid for Pass-through 
commands issued through Command List. 

0 o Status Block is first (or only) Status Block. 

1 Status Block is one of a series of Status 
Blocks. 

DTT Data Transfer Truncated 

Indicates when a SCSI Pass-through 
command completes with fewer bytes 
transferred than requested. 

0 ^ Data transfer was not truncated. 

1 Data transfer was truncated. 

RTY Retry 

Indicates whether a SCSI Pass-through 
command required retries to complete. 

0 <=? No retries were required. 

1 & Retries were required to complete. 

ERR Error Status 

Identifies when a Board-control or SCSI 
Pass-through command completes with an 
error. 

0 No error ocurred. 

1 ^ An error occurred. 

CC Command Complete 

Indicates whether a Board-control or SCSI 
Pass-through command has finished. 

0 Command not complete. 

1 <=> Command complete. 
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Error 

When an adapter-detected error occurs, this byte contains 
an error code to describe the condition. Error Codes are 
described in Appendix A. 

SCSI Status 

When a SCSI device encounters an error it returns to the 
adapter a SCSI Status Byte Code. The adapter reports that 
value here. See Chapter 5 , Figure 5-10 and Table 5-3 and 
either a SCSI specification or your vendor-supplied 
peripheral documentation for a complete description. 

SCSI Sense Bytes 

Most of the Board-control command Status Blocks return 
all zeroes in these fields. SCSI Pass-through command 
Status Blocks return Sense Byte data in these fields. If a 
SCSI error occurs, these eight bytes of sense data help you 
determine the nature of the error. When the RF3570 
adapter receives a Check Condition status from a SCSI 
device, the adapter may issue a Request Sense command 
in response. The device then transfers up to 256 bytes of 
sense data to the adapter. The sense data contains 
information about the error which occurred. From this 
data eight bytes are returned in the status block. The 
default sense bytes returned are 0-7, but through use of 
the Unit Options Command or the Extended Unit Options 
Command , you may select up to 16 of the possible 256 
bytes of Sense Data. More about the use of and difference 
between the Unit Option Command and Extended Unit 
Option Command is available in Chapter 6. If no SCSI 
error occurs, all bytes of Sense data in the Status Block 
will be zero. 

Multiple It is possible to receive more than one Status Block to 
Status Blocks indicate the outcome of a command. To receive multiple 
Status Blocks, all the following must be true: 

• You have used the Unit Options or Extended Unit 
Options Board-control command to set up retries 
and/or extended Sense data for Pass-through 
commands. 

• The command is a Pass-through command. 
(Board-control commands are not subject to retries 
and do not return Sense Data.) 
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# The Pass-through command is issued through use of 
the Command List structure. (Single command 
structures can only contain one Status Block.) 

Setting up Unit Options 

These are the options selected through the Unit Options 
and Extended Unit Options Board-control commands that 
cause the RF3570 to return multiple Status Blocks in 
response to an error condition: 

Retries — If you 1.) supply a Retry Limit value, 2.) select a 
type of retry in the Retry Control field, and also 3.) set the 
ISB bit of the same field, each command retry performed 
will generate at least one Status Block. 

Sense Data — If you select a Sense Count greater than 
eight, or specify over eight Selected Sense Bytes, you will 
receive multiple Status Blocks for each Request Sense 
command sent in response to a Check Condition. 

If you enable both Retries and over eight bytes of Sense Data, NOTE: 

you will receive multiple Status Blocks for every retry 
performed until command completes successfully or Retry Limit 
is reached. This can be calculated as follows: 

For a command that exhausts Retry Limit: 

# of Status Blocks = (# of retries +1) x (# of Status Blocks needed for Sense Data) 

For a command that recovers before Retry Limit is reached: 

# of Status Blocks = ((# of attempts + 1) x # of Status Blocks needed for Sense Data) + 1 
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Single Command There are two ways to issue a command to the KF3570 
Structure adapter. The simplest method involves the use of the 
Single Command structure. This 52-byte structure 
combines a Parameter Block and a Status Block into a 
single structure along with a field that specifies an 
interrupt level and ID. This Single Command structure is 
shown in Figure 4-4. The important things to remember 
about the Single Command structure are: 

• It is designed to be used for initial set-up. 

• The first command you issue to the board after 
power-up or reset must use this structure. 

Format of The Single Command structure is illustrated for you 

Single Command below: 

Structure 



m 


— 


MM®!! 


I Byte Memory Address 




Parameter Block 


(detail for Pass-through commands on page 5-2, 
see Chapter 6 for detail on individual Board-control commands.) 


MWi 

Reserved 

Interrupt 

lilll 

Reserved 



Status Block 

(detail for Pass-through status on page 5-16, 
see Chapter 6 for detail on individual Board-control command status.) 


Figure 4-4: Single Command Structure 


Parameter Block 


This section of the Single Command structure is where 
you build a Parameter Block containing information 
related to the command you wish to execute: 
Pass-through or Board-control. 
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Most of the fields are command-specific; if there is data to 
transfer, for example, an address, address modifier and 
transfer count must be provided. For details about the 
parameter block fields necessary for a SCSI Pass-through 
command refer to Chapter 5, SCSI Pass-through 
Commands and a SCSI specification. For details about a 
Board-control command see Chapter 6, Board-control 
Commands. 


Reserved Fields 

Reserved fields must be zeroed. If a non-zero value is 
permitted in a Reserved block, you may get an error. 

Interrupt 

This field selects the Interrupt level which the RF3570 
adapter will use when the command issued through the 
Single Command structure completes. You can also 
denote the resultant interrupt acknowledge ID that the 
adapter will place on the data bus in response to the Host. 


errs 

■ 

1111 

B 

III 

111 

1111 

ill 

111! 

n 

111 

|!| 

m 

111 

| §| 

ill 

a 

El 

n 

D 

D 

El 

INT 

ID 


Figure 4-5: Bit-meanings of Interrupt Field 


The Interrupt field uses these bit-meanings: 

ID Status/ID 

This byte denotes the Status/ID value that 
the adapter will provide to identify the 
interrupt being acknowledged by the Host. 

INT Interrupt Level 

You may elect to use any one of the 
following levels for adapter interrupt: 

000 — Interrupt disabled 

001 — Interrupt level 1 

010 — Interrupt level 2 

011 — Interrupt level 3 

100 — Interrupt level 4 

101 — Interrupt level 5 

110 — Interrupt level 6 

111 — Interrupt level 7 
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Status Block 

The Status Block is the means by which the RF3570 
adapter communicates successful command completion, 
error conditions, retry information or SCSI Sense Bytes. 
Status Block information specific to the type of command 
you issued can be found in Chapters 5 and 6. 

If the status from a command issued within a Single 
Command structure requires multiple Status Blocks to 
report the status, only the last block is saved in the 
structure. 

NOTE: If you have set the ISB (Issue Status Block) bit in the Retry 

Control field of the Unit Options or Extended Unit Options 
command, it will be ignored for commands issued through 
Single Command structure. 
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The Single Command structure is the fundamental means 
by which you can issue a command to the RF3570 adapter 
board. To issue a command you must perform each of 
these steps in the order described. 

1 .) Clear 52 bytes of system memory at the location you wish 
to create the Single Command structure. 


2. ) Build a Parameter Block in bytes 0 through 28. Refer to 

Chapter 5 for more information about SCSI Pass-through 
commands. Refer to Chapter 6 if you wish to issue a 
Board-control command like Start Command List. 

3. ) Assign a value to the Interrupt field of the Single Com- 

mand structure, reflecting the interrupt the adapter should 
use and the ID by which it will identify the interrupt being 
acknowledged by the Host. The Reserved fields must be 
zero. 

4. ) If you are going to use this command to set bus width and 

byte /word swapping, determine the appropriate value 
for the Control Field of the Address Buffer Port. 

5. ) Write the Control Field, Address Modifier and the two 

address words of the Single Command structure to the 
Address Buffer Port on the adapter. 

6 . ) Read the Status Port. Test the RDY bit (bit 1) to confirm 

that the board is running. Next, verify that bit 0 (ENT) 
indicates the board is ready for a Single Command. (On 
reset or power-up, this bit is set to zero. Thereafter it 
toggles from its previous value to indicate readiness.) 

7. ) Write a 0 value to the Channel Attention Port. 


8.) When the command is complete, the adapter will write a 
Status Block in bytes 36 through 52 of the Single Command 
structure and generate any interrupt you requested. If you 
did not specify an interrupt level in the structure, you must 
poll the CC bit of the Flags byte of the Status Block to 
determine completion. Poll the ENT bit of the Status Port 
to determine when you can issue another Single Com- 
mand. Command pre-fetch allows you to send another 
command to the adapter before the previous is completed. 
Therefore, the CC and ENT bits are not equivalent. 


LJ 


Using a Single 
Command 
Structure 

Set-up 

the Structure 
in memory 


Prepare the 
Hardware Ports 


Execute 
the Command 

Determine Command 
Completion 
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Some Example The following examples will help you understand how to 

Single Commands use the Single Command structure. Two examples are 

given here. The first is an example of a Board-control 
command. The second shows you how to issue a SCSI 
Pass-through command to the RF3570 adapter. 


Example 1 : 
Start Command List 
Board-control 
command 


The Start Command List Board-control command sets up 
a Command List structure for you to use for subsequent 
commands. (Basically, the Command List uses a location 
in memory as a depot for multiple commands and their 
Status Blocks. This feature is discussed in detail later in 
this chapter.) 


This example shows you how to use the Single Command 
Structure to initiate the Command List. 


1 . ) Select a portion of system memory for the Single Com- 

mand structure. You will need 52-bytes of space to hold 
the Parameter Block, Interrupt and Reserved fields, and 
the Status Block that make up a Single Command struc- 
ture. 

Example Memory Address = 822F4H 

2. ) Fill in the Parameter Block information. (Detailed Parame- 

ter Block information for each Board-control command is 
given in Chapter 6.) 


These are the Parameter Block values for this example: 




Byte Memory Address 


Offset 

■imiBi 

Offset *1 


. Offset+S 


Command Identifier = 000822F4H f| 

■■■ 

Reserved 

Addr Mod = 3DH 

ID = FFH | 

lillilll 

Command List Memory Address = 00099450H |j 

IIBMi 

Reserved 

interrupt = 300H 

lillilll 

Command = 01 H 

Reserved 

IIIISM 


Reserved 

I 

1111111 


Reserved 

| 


Figure 4-6: Example Start Command List PB 
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Command Identifier = 822F4H 

Even though the Status Block is part of the Single Com- 
mand structure and easily identified it is good to provide 
a value here in order to be consistent with Command List 
structures. The value chosen is the address of the Single 
Command structure. 

Address Modifier = 3DH 

This value indicates that Standard Supervisory Data Ac- 
cess will be used for Command List data transfers. 

ID = FFH 

Indicates to the RF3570 adapter that this is a Board- control 
command. 

Command List Memory Address = 99450H 

System Memory address of the Command List structure. 

Interrupt = 300H 

Indicates that an Interrupt Level of 3 be used for Com- 
mand List status. 

Command = 01H 

This value is the Start Command List command code. 


3.) Fill in the Interrupt Word of the Single Command struc- 
ture. This is used to indicate the Interrupt Level to be used 
for the Single Command. In this example we will leave it 
zero along with the Interrupt Acknowledge ID. This 
means the Flags byte of the Status Block will need to be 
cleared before issuing the command, and then the Com- 
mand Complete (CC) bit polled to determine when this 
command completes. 


In memory, the structure will look like this: 


Parameter 

Block 



Interrupt and 
Reserved Fields 


Status 

Block 


Figure 4-7: Single Command Structure in memory 

4.) The next step is to load the Address Buffer Port. This will 
require three writes to the port address. Each of the three 
writes is described next: 

Control Field = 84H 

For the first write, the Control Field, we'll select no byte or 
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word swapping of data or control structures, but choose 
to use a 32-bit system bus. 

Address Modifier = 3DH 

This is the Address Modifier that the adapter is to use 
when reading the Single Command Structure. 

Single Command Structure Address = 822F4H 

The other two writes to the port contain the address of the 

Single Command Structure. 

5. ) The example board is jumpered at address EEOOH. The 

three writes to the Address Buffer Port at address EEOOH 
will be as follows: 

1. ) 843DH 

2. ) 0008H 

3. ) 22F4H 

6 . ) Read the Hardware Status Port at address EE10H. Since 

the ENT bit of the Status Port toggles between 0 and 1 with 
each Single Command Channel Attention issue, the value 
returned could be 0202H or 0203H depending on the 
previous value. We'll assume this is the first command 
after a reset; the initial value of the ENT bit is 0. The 
adapter is ready if the Status Port reads 0202H. 

7. ) To execute the command, write a 0 to the Channel Atten- 

tion Port. 


8 .) Poll for command completion by reading the Flags Byte of 
the Status Block and comparing it to zero. When the value 
is non-zero, the command is complete. The value of the 
Flags byte in the Status Block will indicate if the command 
completed with an error. In this example, the command 
was successful; a value of 80H is returned as shown below. 
A returned value of COH would indicate an error had 



occurred. 

822F4 

msmMmmrn 

ilOBlli 

1122101 

llii; 

822F8 

00 

00 

3D 

iliii 

822FC 

00 

1 091 1 

94 

50 

82300 

00 

00 

00 

; 03: 

82304 

•• 01 

110011 

00 

1100;: 

82308 

00 

00 

1 00 

00 

8230C 

00 

00 

00 

00 

82310: 

00 

; oo 

1 00 

00 

82314 

00 

00 

GO 

iiioi 

82318: 

111111:100:11^; 

08 

22 

llii; 

8231C 

00 

00 

00 

80 

82320 

. 00 

00 

oo 

00 

182324 

00 

00 

00 

00 



Parameter 

Block 


Interrupt and 
Reserved Field: 


Status 

Block 



Figure 4-8: Single Command Structure in memory 
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This example describes the issue of a SCSI Pass-through 
command. The SCSI Inquiry command is fully described 
in the SCSI specification. 


Example 2: 
Inquiry 
Pass-through 
command 


This example shows you how to use the Single Command 
structure to issue a Pass-through command. 


1 .) The set-up of a Pass-through command is the same as for 
a Board-control command. You must select a portion of 
system memory for the Single Command structure. You 
will need 52-bytes of space to hold the Parameter Block, 
Interrupt and Reserved fields, and the Status Block that 
make up a Single Command structure. For this example 
well use the same memory address. 

Example Memory Address = 822F4H 


2.) Fill in the Parameter Block information. (Detailed Parame- 
ter Block information for Pass-through commands is given 
in Chapter 5. For information about the SCSI Inquiry 
command, you must reference a SCSI specification or 
drive manual.) 

These are the Parameter Block values for this example: 


it 

Address 

— 1 


. Qffeet+0 

Offset*! 


illl! | 

liisii 

Command Identifier = 000822F4H | 

04H 

Flags-2 = 0 

Flags-1 = 0 

Addr Mod = 3DH 

ID = 01H 

08H 

VME Memory Address = 00099450H 1 

■111 

T ransfer Count = 24H | 

iilliii 

Command = 12H 

LUN =0 

Reserved = 0 

Reserved = 0 | 

lililll 

Allocation = 24H 

Flag/Link = 0 

0 


18H 

0 

0 

0 

0 


Figure 4-9: Example Pass-through command PB 



Command Identifier = 822F4H 

Even though the Status Block is part of the Single Com- 
mand structure and easily identified it is good to provide 
a value here in order to be consistent with Command List 
structures. The value chosen is the address of the Single 
Command structure. 
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ID = 01H 

Indicates to the RF3570 adapter that this Pass-through 
command should be directed to device ID 1. 

Address Modifier = 3DH 

This value indicates Standard Supervisory Data Access 
mode will be used to execute the Inquiry command. 
Flags-1 = 0 

This byte is used to control aspects of command operation. 
None of the features are enabled for this command. 
Flags-2 = 0 

This byte offers further command control options. None 

of the additional features are enabled for this example. 

VME Memory Address = 99450H 

System Memory address to which the Inquiry data will be 

returned. 

Transfer Count = 24H 

This value is the number of bytes of data that will be 
transferred for this command. The Inquiry data returned 
by this device is contained in 36 (24H) bytes. 

SCSI 6 byte Command Descriptor Block 

These six bytes of command information are explained in 

the SCSI specification. 

3.) Fill in the Interrupt Word of the Single command Struc- 
ture. The Interrupt Word is used for the Single Command 
Interrupt Level. 

In this example we'll use an interrupt level of 3, and 
designate a Status/ID of 3FH. This means that the adapter 
will interrupt the Host when the command has completed 
by driving IRQ3. When requested for its Status/ID during 
the VME interrupt cycle, the adapter will respond with the 
value 3FH on lines D0-D7. 


In memory, the structure will look like this: 



Parameter 

Block 


Interrupt and 
Reserved Fields 


Status 

Block 


Figure 4-10: Single Command Structure in memory 


Rimfire 3570 User’s Guide 
4-18 








Command Operation 



4. ) The next step is to load the Address Buffer Port. This will 

require three writes to the port address: 

Control Field = 84H 

For the first write, the Control Field, we'll select no byte or 
word swapping of data or control structures, but choose 
to use a 32-bit system bus. 

Address Modifier = 3DH 

This is the Address Modifier that the adapter is to use 
when reading the Single Command Structure. 

Single Command Structure Address = 822F4H 

The other two writes to the port contain the address of the 

Single Command Structure. 

5. ) The example board is jumpered at address EEOOH. The 

three writes to the Address Buffer Port at address EEOOH 
will be as follows: 

1. ) 843DH 

2. ) 0008H 

3. ) 22F4H 

6 . ) Read the Hardware Status Port at address EE10H. Since 

the ENT bit of the Status Port toggles between 0 and 1 with 
each Single Command Channel Attention issue, the value 
returned could be 0202H or 0203H depending on the 
previous value. We'll assume this is the first command 
after a reset; the initial value of the ENT bit is 0. The adapter 
is ready if the Status Port reads 0202H. 

7. ) To execute the command, write a 0 to the Channel Atten- 

tion Port. 


8 .) When the command has completed, the Status Block will 
be written to memory and an interrupt generated by the 
RF3570 adapter. Read the Flags byte of the Status Block to 
determine if there are errors, or retries associated with the 
command. 


S22W4 

00: 

m 

22 

Mmm 

822F8 ' 

00 

00 

30 : 

lllll:; 

822FC 

00 : 

09 

11:8411 

§ 50 

82300 

00 

00. 

00 

11:24' 

82204 1 1 

12 

00 1 

iliiil 

00 

82308 : 

• ' 24 

00 

00 

GO 

8230C 

00 

•= 00 

00 

1: 00 

82310 

0 0 . 
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Figure 4-1 1 : Single Command Structure in memory 
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Command List The previous pages have discussed the use of a Single 

Structure Command Structure to issue a command to the RF3570 

adapter. This section deals with the other method of 
operation: the Command List Structure. With this 
structure you are able to queue commands for execution; 
use of the Command List Structure enhances performance 
by decreasing command overhead and allowing both 
system and adapter to perform command I/O at the same 
time. 


Format of The address of the Command List Structure should be on 

Command List a double word boundary. The Command List Structure is 
Structure illustrated for you below: 


tftddSress 

Offset 

Byte tommy Address 1 

; Offset+a 


Parameter Block IN Index 

04H 

Parameter Block OUT Index I 

ilia 

Status Block IN Index j 

OCH 

Status Block OUT Index 

iiiiiii 

Number of Parameter Blocks (n) (max = 2034) 


Number of Status Blocks (y) (max = 4096) 

".'"laii §K 

Reserved 

liill 

Reserved 

1111111 

Parameter Block #1 

umi 

Parameter Block #2 

♦ . 

Parameter Blocks (up to #2034) 


Status Block #1 


Status Block #2 


Status Blocks (up to #4096) 


Figure 4-12: Command List Structure 


Description of the The following section describes the information you will 
Fields need to properly complete a Command List Structure. 
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Parameter Block IN Index 

This field contains an index into the Parameter Block 
array. It points to the next open block. When you add a 
Parameter Block to the Command List Structure, you 
must increment this number. This value is never changed 
from the adapter side of operations. 

Parameter Block OUT Index 

This field also contains an index into the Parameter Block 
array, but it points to the next Parameter Block in the 
structure to be read-in by the adapter for execution. This 
value will be incremented by the adapter after it reads a 
new Parameter Block; the value should never be changed 
from the Host side. 


Status Block IN Index 

The Status Block IN field is incremented each time a 
Status Block is placed into the Status Block array by the 
adapter. This value should never be changed from the 
Host side. 


Status Block OUT Index 

The Status Block OUT Index advances when the Host 
reads a Status Block from the array to indicate that a 
Status Block has been read. This value is never changed 
by the adapter. 


Number of Parameter Blocks 

This value indicates the maximum number of Parameter 
Blocks that you can have active in the list. You should 
pick a number that is adequate for the number of 
commands that you will issue. Since the Status Block 
array follows the Parameter Block array, you cannot 
increase this number once execution begins. The 
maximum space available to use for Parameter Blocks is 
65536 bytes. The maximum number of Parameter Blocks 
you can have is 2034. 

0 and 1 are not valid values to use in this field. 
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Number Of Status Blocks 

This value indicates the number of Status Blocks available 
to be written by the adapter in the Command List. 
Maximum space available for Status Blocks is 65536 bytes. 
Since each Status Block is 16 bytes long, the maximum 
number of Status Blocks you can have is 4096. 

0 and 1 are not valid values to use in this field. 

NOTE: Multiple Status Blocks generated from retries or extended Sense 

data must be factored into the value you select for this field. 
Retries and additional Sense data options are enabled through 
use of the Unit Options or Extended Unit Options commands. 


Parameter Block Space 

You may have up to 2034 Parameter Blocks in the 
Command List Structure simultaneously. The Parameter 
Block area is treated as an independent circular list. First 
you place a Parameter Block into this area, then the 
adapter reads it to execute. 

Status Block Space 

You may have up to 4096 Status Blocks in this area 
simultaneously. The Status Block area is treated as a 
circular list separate from the Parameter Block area. When 
the adapter places a Status Block into this area, it is 
available to be read in from the Host side. 

It is possible to generate multiple Command List Status 
Blocks from one Pass-through command if retries are 
enabled and more than eight bytes of Sense data are 
selected. Retries and Sense data are enabled with the Unit 
Options or Extended Unit Options commands. 

Creating the 
Command List 
Structure 


To create a Command List Structure you should perform 
the following steps in the order indicated: 

1 . Select and clear a portion of memory that will contain the 
Command List. The Command List should start on a 
double word boundary. Enough space should be allocated 
to accommodate the Index information plus the Parameter 
and Status Blocks. Use the following information to deter- 
mine the amount of space to allocate. (The value n is the 
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number of Parameter Blocks and the value y is the number 
of Status Blocks to be held in each respective array.): 

Index information = 32 bytes 
Parameter Block array = n x 28 bytes 
Status Block array = y x 16 bytes 

Zero the indexes and set-up the Number of Parameter 
Blocks and Number of Status Block fields. 


2. Issue a Start List command to the adapter within a Single 
Command Structure. An example of how to do this can be 
found on page 4-14. 

3. Create Parameter Blocks in the reserved space, update the 
Parameter Block IN index. Write a 1 to the Channel Atten- 
tion Port to begin execution. 

4. Retrieve Status Blocks from the Status Block reserved area. 
Update the Status Block OUT index. 


The Command List Structure is a fast method of sending 
commands to the RF3570 adapter. This section explains 
usage of the indexes. It also details command issuing 
procedures. 

These guidelines explain the use of the Command List 
Indexes: 


Using a Command 
List Structure 


Index 

Guidelines 


• The respective IN and OUT indexes for the Parameter 
and Status Blocks control each respective circular list. 
The number placed in each index points to an element 
in an array: a 0 is the first element in an array; 1 is the 
second element in an array; etc. 

• The IN indexes indicate the next free block of the 
array to be written from the Host side (Parameter 
Block) or from the adapter side (Status Block). 

• The OUT indexes point to the next block of an array 
to be read in to the Host side (Status Block) or to the 
adapter side (Parameter Block). 

• The IN and OUT Indexes are manipulated with 
standard circular list algorithms; If IN is equal to 
OUT, the list is empty; if IN is equal to OUT minus 
one (modulo list size), the list is full. 
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• The Host side is responsible for updating the 
Parameter Block IN Index and the Status Block OUT 
Index. 

• The EF3570 adapter updates the Parameter Block 
OUT Index and the Status Block IN Index. These 
indexes must not be changed from the Host side. 

• The Parameter Block OUT Index is not necessarily 
changed at the time a command is accepted or for 
each command read onto the board. To reduce 
system bus activity the adapter performs this action 
only periodically to keep the list from filling up. 
Therefore, change in the OUT Index cannot be used 
to signal command acceptance. 

Command Use the following guidelines when issuing commands via 
Guidelines Command List: 

• Several commands can be loaded into the Parameter 
Block array at once and issued with a single write of 
1 to the Channel Attention Port. 

• Similarly, the adapter can return several Status 
Blocks at once; there may not be an interrupt received 
for each Status Block. However, you may also receive 
several interrupts in a row. 

• The issue of commands and receipt of status occurs 
asynchronously; there are no timing restrictions on 
either. 

• The number of possible Parameter and Status Blocks 
is indicated by the two counter fields: Number of 
Parameter Blocks; and Number of Status Blocks. 

Adding a To add an entry to the Parameter Block array, follow these 

Parameter Block steps: 

1 . Compare the Parameter Block IN Index to the OUT Index 
to be sure the array is not full. 

2. Calculate the offset for the Parameter Block indicated by 
the Parameter Block IN Index and build a Parameter Block 
containing the command you wish to issue. 

3. Increment the Parameter Block IN Index. 

4. Write a 1 to the Channel Attention Port. 
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To remove an entry from the Status Block array, follow 
these instructions: 

1 . Compare the Status Block IN Index with the OUT Index to 
find out if the list is empty. 

2. Read in the Block indicated by the Status Block IN Index. 

3. Increment the Status Block OUT Index. 


Example 'C' routines for Command List handling begin 
on the next page. 


LU 


Removing a 
Status Block 
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Example ’C’ 
Routines for 
Command List 


The following 'C listing is included here as an example of 
how you may set-up the Parameter Block, Status Block 
and Command List structures and manipulate the 
Command List Indexes. 


/* Global Defines:*/ 





tdefine 

EMPTY 0 





tdefine 

NPB 100 /* NPB - 

Num 

of Parameter 

Blocks in Command List. */ 

tdefine 

NSB 200 /* NSB - 

Num 

of Status Blocks in Command List. */ 

tdefine 

BYTE unsigned char 


/* 

an 8 bit value */ 

#def ine 

WORD unsigned int 


/* 

a 16 bit value */ 

#define 

DWORD unsigned long 


/* 

a 32 bit value */ 

/* parameter_block — a structure 

used to pass a command to the RF3570 VME to 

* SCSI 
*/ 

typedef 

{ 

adapter. The fields are: 





struct 





DWORD identifier; 


/* 

identifier - command identifier. */ 


BYTE target ; 


/* 

target 

- target ID or adapter ID. */ 


BYTE modifier; 


/* 

modifier - address modifier. */ 


BYTE flags-1; 


/* 

command flags. */ 


BYTE f lags-2 ; 


/* 

command flags 

/* possible values for flags-1 

*/ 




#define 

CF_VALID 


0x80 

/* 

dat and dir bits valid.*/ 

#define 

CF_ FREE 


0x40 

/* 

reserved bit, not used.*/ 

#define 

CF__ INHIBIT_CMD_COMPLETE 

0x20 

/* 

command list synch control. */ 

#define 

CF_ FREE1 


0x10 

/* 

reserved bit, not used. */ 

#define 

CF__IRS 


0x08 

/* 

inhibit request-sense.*/ 

#define 

CFJDATA 


0x04 

/* 

data for this operation. */ 

#define 

CF_DIR 


0x02 

/* 

direction; 1 = (writes) . */ 

#define 

CF_SGO 


0x01 

/* 

scatter /gather operation */ 

/* possible values for flags -2 * 

/ 




#define 

CF_JUST_SEND__MSG 


0x08 

/* 

message-only operation.*/ 

#define 

CF_INHIBIT__DIS CONNECT 


0x04 

/* 

inhibit disconnect. */ 

#define 

CF_TAG_MESSAGE_TYPE 


0x03 

/* 

tag message type. */ 
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union 

{ 

WORD 
DWORD 
} sdp; 

union 

{ 

WORD 
DWORD 
} bytes ; 


w[2 ] , 
d; 


/* sdp - source/dest. memory address */ 


w[2 ] ; 
d; 


BYTE cdb [12 ] ; 

} parameter_block; 

/* status_block — a structure used 
* returned from the adapter. 

*/ 

typedef struct 

{ 


/* bytes - data transfer count */ 

/* cdb - Command Descriptor Block */ 

to hold the status information that is 



DWORD 

sb_ident ; 

/* 

sb_ident - status block identifier. */ 


BYTE 

sb_flag; 

/* 

sb__flag - command completion flags. */ 

/* possible values 

for sb_flag */ 



#define 

ST_CDONE 


0x80 

/* command complete. */ 

#define 

STJ2RROR 


0x40 

/* command error. */ 

#define 

ST_RETRY 


0x20 

/* retry required. */ 

#define 

ST__TRUNCATED 

0x10 

/* data transfer truncated. */ 

#define 

ST__CONTINUED 

0x04 

/* block continued from previous. */ 


BYTE 

sb_error; 

/* 

sb_error - error code number. */ 


BYTE 

sb_status ; 

/* 

sb_status - command SCSI status byte. */ 


BYTE 

sb__res ; 

/* 

sb_res - reserved field. */ 


BYTE 

sb_info [8] 

/* 

sb_info[8] SCSI request sense info. */ 


} status_block; 
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/* clist - a Command List structure 
*/ 

typedef struct 

{ 


DWORD 

pbin ; 

/* 

parameter block IN pointer. 

DWORD 

pbout ; 

/* 

parameter block OUT pointer. 

DWORD 

sbin ; 

/* 

status 

block IN pointer. */ 

DWORD 

shout ; 

/* 

status 

block OUT pointer. */ 

DWORD 

number_pbs ; 

/* 

number 

of parameter blocks . * 

DWORD 

nuiriber_sbs ; 

/* 

number 

of status blocks. */ 

DWORD 

reserved [2] ; 

/* 

two RESERVED fields. */ 


parameter_block pblist[NPB]; /* Parameter Block area. */ 

statusjDlock sblist [NSB] ; /* Status Block area. */ 

} command_l i s t ; 


/* Functions: */ 

/* 

* put_parameter_block - A function to add a command to the Command List 

* 




void put_parameter_block{pb / clist) 
parameter__block pb; 
command__list * clist; 

{ 

/* First: check to see if the list is full */ 
if ( <clist->pbin +1) % NPB == clist->pbout) 

{ 

/* If the list is full, then handle_full_JList */ 

if ( ihandle_ful 1__1 is t {pb, clist) ) — 

return ; 

} 


■*/ 


This may be a 
function call that 
waits for an open 
entry or you could 
choose to return an 
error. 


/* Second: put the Parameter Block into the next available 
* location in the list 
*/ 

clist->pblist [clist->pbin] = pb; 


/* Third: increment the Parameter Block IN index */ 
clist->pbin = {clist->pbin +1) % NPB; 


/* Next issue a Command List Channel Attention */ 


i s sue__cl_channel_a tn { ) 


} /* put_parameter__block */ 


This is a 
separate function 
called to issue a 
Command List 
Channel 
Attention. 
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get_jstatus block - Read a Status Block returned m the Command List 


status_block get_status_block(clist) 
command_list *clist; 

{ 

status_block tsb; 

/* First: check to see if a Status Block is available */ 
if (clist->sbout == clist->sbin) 


/* If the list is empty there are no blocks to read. Check the adapter 
* Status Port for any error conditions, and return. 


handle_empty_sb_list (clist) ; 
return (EMPTY) ; 


This routine could check 
the Status Port for 1 1 H 
error code (no active 
command list). 


/* Second: read the Status Block into a temporary value so that it can be 
* returned at the end of the function. 

*/ 

tsb = clist->sblist [clist->sbout] ; 

/* Third: increment the Status Block OUT index. */ 
clist->sbout = (clist->sbout +1) % NSB; 

/* Next: return with the Status Block. */ 
return (tsb) ; 


} /* get_status_Jblock */ 
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Chapter 5 — SCSI Pass-through Commands 

There are two types of commands that you will issue to Introduction 

the RF3570 adapter: SCSI Pass-through and adapter 

Board-control. Board-control commands are covered in 

the next chapter. This chapter informs you about SCSI 

Pass-through commands. 

When the RF3570 adapter receives a SCSI Pass-through 
command Parameter Block, it passes a command or 
message byte through to the SCSI device that must 
perform the work. The RF3570 will perform the necessary 
negotiation and report the completion status. 

A SCSI Pass-through command Parameter Block can 
contain any SCSI command available for the peripheral 
you are addressing. You should refer to a SCSI and 
Common Command Set (CCS) specification or your 
peripheral vendor manual for more information. This 
chapter describes the Parameter Block structure you 
should use for Pass-through commands. 

This chapter summarizes SCSI Pass-through commands Su mmary 

and can be used as a reference for: 

• Pass-through command Parameter Block format. 

• Pass-through command Status Block format. 

• Pass-through message Parameter Block format. 

• Examples of usage. 

This chapter is most useful for someone writing or 
modifying a driver for the RF3570 product. 


Rimfire 3570 User’s Guide 

5-1 


5 


Pass-through Commands 


SCSI Pass-through 
Parameter Block 
Format 


In Chapter 4, a Base Parameter Block was introduced and 
explained in a general context. Parameter Blocks are the 
same size, with the same general fields, whether you are 
issuing a SCSI Pass-through command or an adapter 
Board-control command. The information specific to SCSI 
Pass-through commands will be covered in this section. 


Command 

Format 


Use this format when issuing a Parameter Block 
containing a SCSI Pass-through command: 



pllil 

Byte Memory Address • 

pjgBBl 

iMliilllllil 

IBHWHi 

IBillilflM 



Command Identifier || 

up 

Flags-2 

Flags-1 

Addr. Mod. 

Target ID | 


VME Memory Address 


Transfer Count 

■■■ 

0 (Opcode) 

1 

2 

3 1 

SIS 

4 

5 

6 

7 

m® 

8 

9 

10 

ii 


Figure 5-1 : SCSI Pass-through Parameter Block 


Description 
of the Fields 


The SCSI Pass-through commands Parameter Block fields 
can be explained as follows: 


Command Identifier 


The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. 


It must be a unique value. 

Target ID 

This value identifies the Target ID of the device that is to 
receive the command contained in the SCSI Command 
Descriptor Block. 
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Address Modifier 


This value further defines the VMEbus Address specified 
for a data transfer. 


Ha 


Addr 

Mod 


Address Modifier 

These six bits inform the RF3570 adapter 
what Address Modifier it should use for 
data transfer. 


Flags-1 

The Flags-1 byte controls the command operation. Its bits 
have these meanings: 


III* 


lllllll 

iim 

I1B1B 

BS3H 

0 

ICC 


Bit-meanings of Flags-1 57T 


SGO Scatter/Gather Operatioi 

Scatter/Gather operation allowryouJ^use 
separate pieces of memory as if it was one' 
contiguous piece. See Chapter 7 for more 
information about Scatter/Gather. 

0 This is not a Scatter/ Gather transfer. 

1 This is a Scatter/ Gather transfer. 

DIR Direction of Data Transfer 

Both the DBV and the DAT bits must be set 
to 1 for this bit to have meaning for an 
KF3570 operation. Otherwise its value is 
ignored. 

0 ^ Data transfer is from the target. 

1 ^ Data transfer is to the target. 


1 bits IIIHI 1 

llllill 

iiiriiiii 


— 


1111111 

MHWj) 


0 


Addr Mod v 


Figure 5-2: Bit-meanings of Address ModifiekField 



Valid Address 
Modifier values 
can be found by 
referring to a VME 
Specification, 
Revision C.1 


EH 


MUM 

IIHB 

0 

m 



■n 




These three bits 
work 

intra-dependently. 
They are 

automatically set by 
the adapter to 
specific values for 
standard SCSI and 
SCSI-2 commands. 
Their values are 
described in Table 
5-1, following the bit 
descriptions. 


Rimfire 3570 User’s Guide 

5-3 
























Pass-through Commands 


DAT Data Transfer 

This bit is available to be used to enhance efficiency 
of vendor-unique commands. (It is automatically 
set for standard commands.) If the command you 
are issuing is vendor-unique, this bit informs the 
adapter that a data-in or data-out phase will occur 
during the command. 

0 Command has no data phase. 

1 Data phase will occur. 

IRS Inhibit Request Sense 

Selects whether Sense Data is to be gathered 
automatically by the adapter (in response to a 
Check Condition status from a device) or given to 
the host to do so. 

0 ^ Automatic Request Sense issued to device 
reporting Check Condition. 

1 & Check Condition status of device reported to 
Host. Host must request the device status. 

ICC Inhibit Command Complete Interrupt 

Inhibits the interrupt that notifies the host of 
command completion. By inhibiting interrupts for 
a number of commands and then enabling an 
interrupt for one, you can reduce the number of 
interrupts to service. 

0 ^ Interrupts enabled for this command. 

1 Interrupts inhibited for this command. 

DBV Data Bits Valid 

Use this bit when you wish to override the default 
values of the DAT and DIR bits to implement 
vendor-unique commands or alter those 
automatically set for standard SCSI as shown in 
Table 5-1. 

0 Normal operation, use values in Table 5-1. 

1 ^ DIR and DAT values in the Flag byte are valid 
and override the defaults in Table 5-1. 
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The DAT and DIR bits, together, indicate whether a data Setting DBV, DAT and 

transfer should be expected for a given command, and if DIR Bits 

so, which direction it will be: to or from the target. The 

DBV bit gates whether the values for DAT and DIR will 

be derived from the default table or from the values you 

assign. 


The following table of defaults is useful for you to use Using the 

when you wish to: 1.) alter the default behavior of a Table Values 

standard SCSI command for a specific application or 2.) 
implement a vendor-unique command. 

An example of altering the default function of a command 
can be demonstrated with the SCSI Format command. If 
you examine the DAT, and DIR bit values for this 
command in the table, you see that the adapter assumes: 


Opcode 


IIMliiillli 


04H 

i 

i 

Format Unit 

Figure 5-4: Example DAT and D 

1R bit settings 


The ones in the table for DIR and DAT mean that by 
default the adapter will assume that there is data 
associated with the command and the direction of data 
flow is to the target. 

If the Format command for your device requires no data 
transfer, set the Flags-1 byte as follows when you issue the 
Format command: 

DBV = 1, DAT = 0, DIR = 0. 

Setting DBV to one tells the adapter to examine your 
settings for DIR and DAT and their zero settings indicate 
no data is associated with the command. 
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An example of the second case, implementing a 
vendor-unique command, can also be given. Suppose 
your SCSI device has a vendor-unique command 
available for Opcode 02H. When you examine the table 
for the default settings of that opcode you see that the 
KF3570 adapter assumes: 


|| • Opcode 

111111111111 

11111111111 


1 02H 

.0 

0 

not defined 

Figure 5-5 p©IR and 

DAT Settings, Vendor-unique 


In this example, suppose the 02H opcode vendor-unique 
command involves a data transfer from the device to the 
adapter. To override the table values and use the opcode 
for a vendor-unique command set the DBV, DAT and DIR 
bits of the Flags-1 byte as follows: 

DBV = 1; DAT = 1; DIR = 0. 


This combination means: DBV is set so use Flags-1 field 
values for DAT and DIR; DAT is set so data will be 
transferred; DIR is zero so direction of transfer is from the 
device. 

NOTE: If you set a combination of DBV, DIR and DAT that is 

inconsistent with how your target executes the command, you 
will receive error code 24H, Unexpected SCSI Phase 
Encountered. You must refer to your vendor-specific 
documentation for information about your peripheral's 
command execution. 
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The following table demonstrates the values for the DAT 
and DIR bits that the RF3570 associates by default with 
each of the SCSI opcodes: 


Table of DAT and DIR 
Automatic Settings 



07H 

1 

08H 

1 


16H 

1 

17H 

1 

18H 

1 



H Description 


Test Unit Ready 


Rewind/Rezero 


not defined 


Request Sense 


Format Unit 


Read Block Limits 


not defined 


Reassign Blocks 


Read 


not defined 


Write 


Seek 


not defined 


Read Reverse 


Write Filemarks 


Space 


Inquiry 


Verify 



Recover Buffered Data 


Mode Select 



Reserve 


Release 


Copy 


Erase 


Mode Sense 


Start/Stop: Load/Unload 


Receive Diagnostic 


Send Diagnostic 


Prevent/Allow Media Removal 


not defined 


Table 5-1: DAT and DIR Automatic Settings 
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Table 5-1: DAT and DIR Automatic Settings (continued) 


■MIMH 


HK 


20H 


21H 


22H 


23H 


24H 


25H 


26H 



tilMllMlIl 

11111 | Description 8111111 

0 

■ 

0 


0 

not defined. 

0 

1 

0 



3DH 

0 

3EH 

1 

3FH 

1 


Read Capacity 


not defined 


Extended Read 


Vendor-unique 


Extended Write 


Extended Seek 


Ciprico defined 


Ciprico defined 


Write and Verify 


Verify 


Search Data Equal 


Search Data High 


Search Data Low 


Set Limits 


Pre-fetch Cache 


Synchronize Cache 


Lock/Unlock Cache 


Read Defect Data 


not defined 


Compare 


Copy and Verify 


Write Buffer 


Read Buffer 


not defined 


Read Long 


Write Long 
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Table 5-1: DAT and DIR Automatic Settings (continued) 


jjjjgjjii 


Miiiiiiiiii 


60H 

0 

0 

not defined 

thru 

A3H 

A4H 

i 

0 

Ciprico defined 

A5H 

0 

0 

Move Medium/Play Audio 

A6H 

0 

0 

Exchange Medium 

A7H 

0 

0 

not defined 

A8H 

1 

0 

Read (12)/Get message 

A9H 

0 

0 

Play Track Relative 

AAH 

1 

1 

Write (12)/Send message 

ABH 

0 

0 

not defined 

ACH 

0 

0 

Erase (12) 

ADH 

0 

0 

not defined 

AEH 

1 

1 

Write and Verify (12) 

AFH 

0 

0 

Verify (12) 

BOH 

1 

1 

Search Data High (12) 

B1H 

1 

1 

Search Data Equal (12) 

B2H 

1 

1 

Search Data Low (12) 

B3H 

1 

1 i 

Set Limits 

B4H 

0 

0 

not defined 

B5H 

1 

0 

Request Volume Element 
Address 

B6H 

1 

1 

Send Volume Tag 

B7H 

1 

0 

Read Defect Data (12) 

B8H 

1 

0 

Read Element Status 

B9H 

0 

0 

not defined 

thru 

BFH 

COH 

0 

0 

Ciprico defined 

C1H 

0 

0 

not defined 

C2H 

1 

0 

Ciprico defined 

C3H 

1 

0 

Ciprico defined 
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Flags-2 


The bits of this field are used to select SCSI-2 and 
additional command control features implemented by the 
RF3570 adapter. The meanings of the bits are as follows: 



TAG These two bits let you choose the tagged queuing 
OPTS method you wish used with the current command. 
You can choose one of three types of messages for 
the KF3570 adapter to use when issuing the 
command. 


■■■I 

lliippiii 

Meaning; 

00 

SIMPLE QUEUE TAG MESSAGE: The command may 
be processed by the SCSI-2 device out of sequence for 
efficiency. Example: device may sort commands by 
logical block address. 

01 

ORDERED QUEUE TAG MESSAGE: The command 
must be executed by the SCSI-2 device in the order sent 
by the adapter (in order with respect to other commands 
sent with the ORDERED QUEUE TAG Message). 

10 

HEAD OF QUEUE TAG MESSAGE: The command is 
executed by the SCSI-2 device before all other 
commands previously sent, including other Head of 
Queue Tag commands but excluding command currently 
in process. 

11 

Reserved 


Table 5-2: Meaning of TAG OPTS Bits 


In order for these bits to apply to the current 
operation you must have already enabled tagged 
queuing with either the Unit Options or Extended 
Unit Options command. These commands are 
covered in detail in Chapter 6, Board-control 
Commands. If you do not enable 
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tagged queuing with the Unit Options or 
Extended Unit Options command, the TAG 
OPTS bits are ignored. 

For more information about the use of 
tagged queuing, see the usage discussion in 
Chapter 7. 

Depending on the SCSI-2 device you are using, you may also 
need to enable tagged queuing with a MODE SELECT page 
OAH, Common Device-Type Control Parameters command to 
the device. See your vendor-supplied peripheral documentation 
for more information. 

IAD Inhibit Automatic Disconnect 

If you enable SCSI disconnect privilege with 
the DIS bit of the General Options 
Board-control command (Bit 0 of Select 
Flags field), disconnects will automatically 
be tried for any command. Use the IAD bit 
to disable SCSI device disconnect/reconnect 
privilege for the current command. This can 
be important for performance reasons. 

0 ^ Determine disconnect from the DIS bit 
of General Options command. 

1 ^ Ignore DIS bit, inhibit the disconnect 
privilege. 

JSM Just Send Message 

Use this bit to change the SCSI Pass-through 
Command Parameter Block to a Pass-through 
Message Parameter Block. In this Message 
mode, the adapter selects a device and only 
sends a message. This provides a measure of 
error recovery at the host level. 

0 ^ Pass-through command operation as 
usual. 

1 ^ Use the Pass-through Message 
Parameter Block format. 

This message-only format is illustrated on 
page 5-15, following the description of the 
Pass-through command structure. 


E 


NOTE: 
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VME Memory Address 

When the SCSI operation involves a data transfer, this 
field contains the beginning address for the transfer. If the 
SCSI command you are issuing does not require a data 
transfer, this field and the Address Modifier field are 
ignored by the adapter. 


Transfer Count 

This field determines the number of bytes that will be 
transferred to or from host memory. For some SCSI 
commands this is an indeterminate number. In that case, 
there are two ways to use this field: 

1 . ) You can place a value in the field to represent the 
maximum number of bytes the adapter may transfer. Then, 
if the target attempts to transfer more data than this, the 
adapter will discontinue the operation and return a Status 
Block. 

2. ) Alternately, you could place a zero value in this field. 
This causes the adapter to continue to accept data transfer 
requests from the target until command is complete. 


SCSI Command Descriptor Block 

These 12 bytes of the SCSI Pass-through Parameter Block 
are reserved for the actual SCSI command that will be 
passed to the drive. Except for the first byte, which 
contains the command opcode, each SCSI command uses 
the bytes for a different purpose; see a SCSI specification 
or vendor-supplied peripheral documentation for details 
about the commands and fields. 

SCSI commands may be 6, 10, or 12 bytes in length. Any 
of the 12 bytes reserved for the SCSI command that are 
unused are ignored. The SCSI command block is passed 
to the SCSI device exactly as presented. The RF3570 
adapter doesn't alter any of the fields you set up. 
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When you set the JSM bit in the Flags-2 field of the Message 

Pass-through Parameter Block, the format of the Format 

Parameter Block changes: 


Ackfi&SS 

\ Offset 



Byte Memory Address 

Offset +0 

Olfeet*1 -1 

Offset* 2 

Offs et*3 

1 00H : 

Commanc 

Identifier 

III! 

Flags 2 

Flags 1 

Addr, Mod. 

Target ID j 

ea*" 

VME Memory Address 

III— 

Transfer Cosnf 

MBBi 

Message Code 

LUN 

2 

3 

lllWili 

4 

S 

s 

7 

18H 1 

B 

s 

10 

11 


Figure 5-7: SCSI Pass-through Message Parameter Block 


All fields that appear in light text above are ignored when Description 
the JSM bit of the Flags-2 byte is set. of the Fields 

The Command Identifier and Target ID fields work the 
same as explained in the preceeding pages. The JSM bit of 
the Flags-2 field is the only bit in that field that is valid. 

Message Code 

Currently there are three messages that are valid to 
appear in this field. They are: 

06 H - ABORT 

OCH - BUS DEVICE RESET 

OEH - CLEAR QUEUE 

Other messages will not be passed to the device and will 
create an error status. Error code returned is 01H (invalid 
command). 


LUN 


This field has the same format as specified in the SCSI 
specification for LUN (Logical Unit Number); the 3 most 
significant bits hold the LUN value. 
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SCSI PaSS-through In Chapter 4, a Base Status Block was introduced and 

Status Block explained in general terms. The Status Block for a SCSI 

Format Pass-through command encompasses the same fields used 

for the Board-control commands, plus it holds 
information that is particular to a SCSI transaction: a SCSI 
status byte, and eight bytes of Sense data returned from 
the SCSI device. 


The Sense Data fields are an important part of the Status 
Block. Sense data is acquired directly from the SCSI 
device; you can enable the adapter to automatically 
request Sense Data in response to an error condition 
reported from the device. What you will see in these 
fields is affected by your use of the Unit Options or 
Extended Unit Options Board-control commands. If you 
use one of these commands to have more than eight bytes 
of Sense Data returned, you will receive multiple Status 
Blocks. 


This section includes information about all the fields you 
will see when examining a Status Block returned from a 
SCSI Pass-through command. 


The fields 
displayed in 
light type are the 
default Sense 
Bytes returned 
by SCSI 
Pass-through 
commands 


Status Block This is the format you can expect from a SCSI 
Format Pass-through Status Block: 


a&llSil 






00H 

Command Identifier | 

Mill 

Reserved 

SCSI Status 

Error 

Flags 

IM 

0 = Class/Code 

1 ~ Seamen! 

2 - SCSI Flags 

3 - Info Bytes j 

LdghH 

4 - info Bytes 

Selected Sen: 

5 as Info Bytes 

;e Bytes 

B ~ info Byte 

7 ~ Ex Length 


Figure 5-8: SCSI Pass-through Status Block 


Description Following is a brief description of each of the fields: 

of Fields 


Command Identifier 

This value links a Status Block with a Parameter Block. 
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Flags 


This byte can be polled to ascertain whether, and in what 
condition, a command completed. It has the following 
format: 



CSB Continued Status Block 


This bit indicates that the current Status 
Block is one of several Status Blocks 
generated because extended Sense Bytes are 
enabled. Only valid for Pass-through 
commands issued through Command List. 

0 o Status Block is first (or only) Status Block 

1 & Status Block is one of a series of Status 
Blocks. 

DTT Data Transfer Truncated 

Indicates when a SCSI Pass-through 
command completes with fewer bytes 
transferred than requested in the Transfer 
Count field. 

0 & Data transfer was not truncated. 

1 <=» Data transfer was truncated. 

RTY Retry 

Indicates whether a SCSI Pass-through 
command required retries to complete. 

0 No retries were required. 

1 & Retries were required to complete. 

ERR Error Status 

Identifies when a command. Board-control 
or Pass-through, completes with an error. 

0 ^ No error occurred. 

1 An error occurred. 

CC Command Complete 

Indicates whether a command has finished. 

0 ^ Command not complete. 

1 ^ Command complete. 
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Error 

When an adapter-detected error occurs, this byte contains 
an error code to describe the condition. See Appendix A. 

SCSI Status 

When a SCSI device completes a command, during the 
STATUS phase of the SCSI bus it returns a SCSI Status 
Byte Code to the adapter. The adapter reports that value 
in this field. The field has these bit meanings: 



Status Implementation of these bits is required for all 
Byte devices that adhere to SCSI specifications. See 
Code T a bi e 5_3 (below) for information about what they 
mean. 


Status 

mx 1 

Code*; 

| 


lill 

111 

111 

11 ! 

Ii«i 

B 

B 

Good 

00H 



D 

D 

D 

D 

D 


Check Condition 

02H 

R 

R 

D 

D 

0 

n 



Condition Met/Good 

04H 

R 

R 

D 

D 

D 

n 

D 

R 

Busy 

08H 

R 

R 

D 

D 



n 

R 

Intermediate/Good 

10H 



D 

1 

9 

9 

n 


Intermediate/Condition 

Met/Good 

14H 

R 

R 

D 


D 

i 

0 

R 

Reservation Conflict 

18H 

R 

R 

n 

1 

1 

D 

ci 

R 

Queue Full 

28H 

R 

R 

i 

0 

1 

0 

0 



R = Reserved 

* Assumes that R values are zero. 


Table 5-3: Meaning of Status Byte Code 


Further information about the Status Byte Code can be 
found in the SCSI or SCSI-2 specification. 
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SCSI Status Field during Unexpected SCSI Phase 

In the event that the adapter encounters an unexpected 
SCSI phase it does two tilings: posts an error (24H) in the 
Error field of the Status Block, and reports the phase 
encountered in the last three bits of the SCSI Status field. 
The bits correspond to the MSG, C/D, and 1/ O signals. At 
the time of an Unexpected SCSI Phase Encountered error, 
the SCSI Status field has the following bit-meaning: 


mm 


IB 

imM 

MUM 

— 

MMHi 

111111 

Mi 

UMll 

X 

X 

X 

X 

X 

M 

c 

i 1 


Figure 5-11: SCSI Status Field - Unexpected SCSI Phase 


I I/O (Input/ Output) Signal from Target 

C C/D (Control/Data) Signal from Target 

M MSG (Message) Signal from Target 

X May be either 0 or 1 


The unexpected phase encountered can be determined by 
interpreting the state of the three signals: 





Piiiilll 

—1 

I/O 1 


0 

0 

Data Out 

Initiator to target 


^HQHI 

1 

Data In 

Initiator from target 

1 

1 


Command 

Initiator to target 

1 0 

1 

1 

Status 

Initiator from target 

1 

0 

0 

Reserved 

— 

1 

0 

1 

Reserved 

— 

1 

1 


Message Out 

Initiator to target 

1 

1 

1 

Message In 

Initiator from target 


Table 5-4: Meaning of Status Byte - Unexpected Phase 


See your SCSI or SCSI-2 specification for more 
information about SCSI phases. 
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Sense Bytes 

When enabled to do so (the IRS bit of the Flags-1 field of 
the Pass-through command is not set), the RF3570 adapter 
automatically responds to Check Condition status from a 
device, with a Request Sense command. 

The device answers the Request Sense command by 
returning information about its condition. This 
information is called Sense Bytes. Depending on the 
peripheral, up to 256 Sense Bytes can be returned in 
response to the Request Sense command. 

There are three ways that Sense Bytes can be reported to 
you by the RF3570 via the Sense Bytes fields of the Status 
Block: 




The first eight bytes of Sense data returned (this is the 
default). 


• Up to 32 of the first sequential Sense Bytes. 

• Up to 16 of any of the 256 possible Sense Bytes 
remmed. 


You can specify one of these methods, for Sense Bytes to 
be reported in the Status Block of SCSI Pass-through 
commands, by using the Unit Options or Extended Unit 
Options Board-control command (See Chapter 6). 


If no Check Condition status occurred, or the automatic 
Request Sense capability of the adapter is not enabled, the 
Sense Bytes fields will all be zero. See page 5-4 for more 
information about how to inhibit the automatic Request 
Sense command (using the IRS bit). 

Default Sense Bytes 

You will receive the default eight bytes of Sense data if 
you place a zero in the Sense Count field and zeroes in all 
fields of the Selected Sense Bytes of the Unit Options or 
Extended Unit Options Board-control command. 
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The default values returned are: 



[ Offset +0 

Offset* 1 

Offset* 2 


Command identifier 

Reserved 

SCSi Status 

Error 

Flags j 

0 = Class/Code 

1 = Segment 

2 = SCSI Flags 

3 = Info Byte j 

4 = Info Byte 

5 = Info Byte 

6 = Info Byte 

7 = Ex Length | 


Figure 5-12: Default Ordering of Sense Bytes 


Only one Status Block is required to return the default 
Sense Bytes. 

Up to 32 Sequential Sense Bytes 


This option is chosen by placing a number (up to 32) in 
the Sense Count field of either the Unit Options or 
Extended Unit Options command. The Selected Sense 
Bytes fields are ignored. 

This is useful if all pertinent information occurs within the 
first 32 bytes of Sense data returned from your device. 


If you enable more than eight bytes of sequential Sense 
data to be returned, they will be returned in multiple 
Status Blocks. For example, the first sixteen would appear 
in this order: 


j Byte Mteanory Offset j 

Offset* 0 Offset + 1 

Offset +2 


j Command Id&^tsfssr 

Reserved 

SCSI Status 

Error 

Flags 

0 = Class/Code 

1 = Segment 

2 = SCSI Flags 

3 = Info Byte | 

4 = Info Byte 

5 = Info Byte 

6 = Info Byte 

X 

00 

II 


Command Identifier j 

1 Reserved 

SCSI Status 

Error 

Flags 

8 

9 (Comm: 

ind or 10 

11 

1 k 

Vendor-1 
13 Valu 

Jnique 
») 14 

15 


Figure 5-13: Ordering of 1st 16 Sequential Sense Bytes 


Sense Bytes 
in Status 
Block #1 


Sense Bytes 
in Status 
Block #2 


Rimfire 3570 User’s Guide 

5-21 






5 


Pass-through Commands 


Sense Bytes I 
in Status — ■- 
Block #1 I 


Sense Bytes I 

in Status ■ 

Block #2 I 


Selectable Sense Bytes 


You also have the option to select which (up to 16) of the 
256 possible Sense bytes be returned in the Status Block 
and in what order they should appear. 

• The Unit Options command allows you to choose 8 
selectable Sense Bytes. 

• The Extended Unit Options command allows you to 
choose 16 selectable Sense Bytes. You will receive 
multiple Status Blocks. 

You can specify Selectable Sense Bytes by placing a zero 
in the Sense Count field and filling each of the Selected 
Sense fields with the Sense Byte number you wished 
returned in that field. 


For example, the Sense Bytes fields of a Status Block could 
return the following Sense Bytes in the following order if 
the Extended Unit Options command had been used. 


| lifemoiiy Offset 

iiiiliiiiiiB 




Command fcfentlflor || 

Reserved 

SCSI Status 

Error 

Flags 

0 

1 

2 

6 

5 

4 

3 

7 

: 

Command fdanti? jar 

Reserved 

SCSI Status 

Error 

Flags 

56 

57 

13 

19 

122 

33 

12 

23 


Figure 5-14: Example of Selectable Sense Bytes 


Status Block #1 contains the first eight bytes with the Info 
Bytes arranged from LSB to MSB, and Status Block #2 
returns Sense Bytes that are selected from among the 
other 248 Sense Bytes, based on information in the 
vendor-supplied peripheral documentation. 
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Chapter 6 — Board-control Commands Reference 

There are two types of commands that you will issue to Introduction 

the RF3570 adapter: SCSI Pass-through commands, and 
adapter Board-control commands. This chapter 
concentrates on Board-control commands. 

When the RF3570 adapter receives a Board-control 
command it must interpret the command, then apply to 
its operation whatever was specified in the command. 

Board-control commands allow you to communicate 
set-up information and operational guidelines to the 
RF3570 adapter, as well as request current information 
from the board, perform diagnostics, and selectively reset 
the SCSI bus. This chapter is intended to be used as a 
look-up reference for these Board-control commands 
issued to the adapter. 

If you need information about the SCSI Pass-through 
commands available, see a current SCSI or SCSI-2 
specification and CCS addendum. See Chapter 5 for 
information about initiating a Pass-through command. 

This chapter provides detail about each individual S U m ma ry 

Board-control command: 

• The command code 

• A description of the command 

• Exjolanation of unique flags and Parameter Block 

• Examples of command usage where helpful 
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Using the 
Reference 


Board-control Command Reference 


This chapter is most helpful to someone writing or 
modifying a driver for the RF3570 product. 

The RF3570 adapter recognizes the type of command it is 
receiving by the contents of the Target/Adapter ID field of 
its parameter block. If the Target/Adapter ID field contains 
a number between 0 and 7 (indicating SCSI target 
addresses) the command is a SCSI Pass-through 
command. If the Target/Adapter ID field contains an FFH, 
the adapter recognizes it as a Board-control command. 

This chapter explains only the Board-control commands. 
The Tar get/ Adapter ID field will always be set to RFH for 
these commands. In this chapter it is referred to as just the 
Adapter ID field. 

Each of the Board-control commands are completely 
described in the following pages; each description follows 
the same format: 

• First the Parameter Block format is illustrated for 
each command. The fields that are valid appear in 
bold type. 

• Next, each field used by the command is explained. 

• Last, if there is a special type of Status Block returned 
by the command, it is displayed and all of its fields 
explained. 
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When a Board-control command does not return a special General Status 

type of Status Block, it is assumed that its Status Block Block 

will take the general format. That format is described here 
for reference. 

The format of the Status Block returned by most General Status 

Board-control commands takes this form: Block Format 


wmm 

Offset 

Byte Memory Address | 

IliiiMiiiiii 



Offset +3 

mi 

Command 

Identifier j 

04H 

Reserved 

Error 

Flags 

08M 

Reserved 



Figure 6-1 : General Status Block 


Following is a brief description of each of the fields used 
to return General Status: 


Description 
of Fields 


Command Identifier 

This value is used to match a Status Block to its Parameter 
Block. 
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E 


Flags 

This field can be polled to ascertain whether, and in what 
condition, a command completed. It has this format: 


lii 


WBM 

Mill 


11118111 

1111B 


luaiii 

■in 

I CC 

ERR 

0 

0 

0 


0 



Figure 6-2: Bit-meanings of Flags Field 


ERR Error Status 

Identifies when a command completes with an 
error. 

0 ^ No error occurred. 

1 o An error occurred. 


CC Command Complete 

Indicates whether a command has finished. 

0 & Command not complete. 

1 <*> Command complete. 


NOTE: The Flags byte returned in the Status Block of a Board-control 

command reserves the bits other than ERR and CC. However, 
three of the reserved bitfields are used in the Flags byte 
returned in the Status Block of a Pass-through command. See 
Chapter 5 for more information. 

Error 

When an adapter-detected error occurs, this byte contains 
an error code to describe the condition. See Appendix A. 
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These are the Board-control commands that you can use List of Commands 

to set-up the RF3570 operation in your system. 



Command Maine -llllll 


01 H 

Start Command List 

6-6 

02H 

Stop Command List 

6-8 

05H 

Identify 

6-10 

06H 

Board Statistics 

6-14 

07H 

General Options 

6-18 

08H 

Unit Options 

6-22 

09H 

Diagnostic/Self-test 

6-30 

10H 

SCSI Hard Reset 

6-34 

15H 

Board information 

6-36 

16H 

Extended Board Statistics 

6-48 

18H 

Extended Unit Options 

6-52 
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Start Command 
List (01 H) 


With this command you can instruct the RF3570 adapter 
to begin operating from a Command List. Since with 
Command List operation you can attain higher 
performance from your SCSI peripheral, this is one of the 
first commands you should issue to the adapter. It must 
be issued by means of a Single Command Structure. 

See Chapter 4, Command Operation for information 
about using Command Lists. 


Command The Parameter Block Format for the Start Command List 

Format command looks like this: 


Address 

Offset 


BiiiiiiiiM 


| Offset + 2 ' 

— 

1HI1 

Command Identifier | 

111111 

Reserved 

Addr Mod 

Adapter ID = FFH | 

111111 

Command List Memory Address 

Ml 

Reserved 

Interrupt 

10H 

Commands 01 H 

Reserved | 

HIM 

Reserved 

Mil 

Reserved 


Figure 6-3: Start Command List Parameter Block 


Description Each of the fields used by the Start Command List 
of Fields command are explained in the following section: 

Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must be 
a unique value. 

Adapter ID 

This field must always contain the ID of FFH to indicate a 
Board-control command. 

Address Modifier 

This is the value that the adapter is to drive onto the 
VMEbus Address Modifier Lines when selecting the 
memory address of the Command List. 
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Command List Memory Address 

This field contains the address of the Command List in 
Memory. It points to the beginning of the structure: 
Parameter Block IN index. 


Interrupt 

This field defines the interrupt level for the adapter to use 
when reporting command completion. You can also 
denote die resultant interrupt acknowledge ID that the 
adapter will place on the data bus in response to the host. 
The Interrupt field of the Start Command List Parameter 
Block uses these bit-meanings: 


| BITS | 

isi 

Ml 

l§|| 

llii 

j||| 

18 

§§§! 

j s j 

Hi! 

111 

III 


! a; 

mi 

HI 

■ 

n 

D 

□ 

D 

D 

INT 

Status/ID 


Figure 6-4: Bit-meanings of Interrupt Field 


Status/ID Interrupt Status/ID 

This byte denotes the value the adapter will 
provide to identify the interrupt being 
acknowledged by the Host. 

INT Interrupt Level 

You may elect to use any one of the 
following levels for adapter interrupt: 

000 — Interrupt disabled 

001 — Interrupt level 1 

010 — Interrupt level 2 

011 — Interrupt level 3 

100 — Interrupt level 4 

101 — Interrupt level 5 

110 — Interrupt level 6 

111 — Interrupt level 7 



Command Code 

This field indicates the command to be executed. For the 
Start Command List command it is always equal to 01H. 

An Error Code ofllH will be returned in the Status Block if NOTE: 

you attempt to start an already started Command List. 
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Stop Command 
List (02H) 


The Stop Command List command is used to gracefully 
halt Command List operations. Upon receipt of this 
command, the adapter will accept no further additions to 
the Command List queue. 

After all other existent commands are executed from the 
Command List, a Status Block for this command is 
returned. 

The Stop Command List command is useful when you are 
shutting down your system. It processes and returns 
status of commands current at the time of its issue, 
therefore you can be sure all data is transferred properly 
before shutdown. 

This command should be issued via a Single Command 
Structure. 


Command The format of the Stop Command List Parameter Block is 

Format shown below: 


iiHiH 

aunt 


MiHUIMI 




GQH 

Command Identifier | 

04H 

Reserved 

Adapter ID = FFH 

(HBI 

Reserved 

OCH 

Reserved 

ioh: 

Command = 02H 

Reserved | 

1MB 

Reserved f 

Billi 

Reserved j 


Figure 6-5: Stop Command List Parameter Block 


Description Each of the fields used by the Stop Command list 

of Fields command are explained in the following section: 

Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must 
be a unique value. 
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Adapter ID 

The Stop Command List command is a Board-control 
command. To identify it as such to the RF3570 adapter, 
this field must contain the value FFH. 


Command Code 

The command code to use to indicate the Stop Command 
List command is 02H. 


An error code ofllH will be returned in the Status Block for 
this command if you attempt to stop a Command List that is 
stopped (or has not been started). 


E 



NOTE: 
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Identify (05H) 



This command returns a special Status Block that contains 
information about the Firmware installed on the board. It 
can be used to determine board compatibility and support 
of options (especially useful if your application depends 
on certain functions to be in place on every product). 

The Identify command can be issued with either type of 
command structure. Its primary use may be during 
initialization, which may require use of a Single 
Command Structure (due to limitations on available 
memory at power-up). 


Command The Parameter Block format for the Identify command 
Format looks like this: 



Offset 



— 

Command Identifier || 

mm 

Reserved | Adapter ID = FFH 

08H 

Reserved 

am 

Reserved | 

TOW : 

Command = 05H 

Reserved 

wmmmm 

timii 

Reserved 

ISJf 

Reserved 


Figure 6-6: identify Command Parameter Block 


Description 
of Fields 


The Identify command requires only three fields as 
explained in the following descriptions. 


Command identifier 


The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must 
be a unique value. 

Adapter ID 

An FFH indicates that this is a Board-control command. 

Command Code 


The Command Code for the Identify command is 05H. 
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The Status Block returned by the Identify command Identify Command 

contains fields that are slightly different from the Status Block 

standard Status Block. The fields of this special Status 
Block are described below: 


ills 

Offset; 

Byte Memory Address 



Offset + 2 V 


GQH 

Command 

Identifier || 

BUM 



Error 

Flags 

08 H 

Option Flags 

Day 

Month 

Year 


■ 1 I * | 

mm Firmware Number of Even Prom 


Figure 6-7: Identify Command Status Block 


The Status Block returned from an Identify command Description 

contains these fields: of Fields 



Command Identifier 

The value in this field will be identical to the Parameter 
Block Value. 


Flags Field 


This byte is used to indicate command completion. It has 
this format: 


| BITS 

B 


HUM 

iMM 

IMIM 

1KHMI 

MB 

illiilllll 

CC 

ERR 

0 

| 

0 

0 

0 

Dl 


Figure 6-8: Bit-meanings of Flags Field 


ERR Error Status 

Indicates if the command completed with an 
error. 

0 No error occurred. 

1 ^ A command execution error occurred. 

CC Command Complete 

Indicates a command has finished. 

0 Command is not complete. 

1 & Command has completed. 
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Error 

When an adapter-detected error occurs, this byte contains 
an error code to describe the condition. See Appendix A 
for descriptions of all codes that could occur in this field. 


Engineering Revision 

This field indicates the revision level used by Ciprico to 
identify its source code. This field is useful only for 
Ciprico and should not be used to identify the revision 
level of the board firmware. 


Firmware Revision 

This field contains a value that identifies the released level 
of Firmware for the product. 


Option Flags 

The Options field of the Identify command Status Block 
has the following format. 


1 BITS • ' | 


$ 

liiii 

mm 

3 

MMI 

■1 

■an 

1 SCSI ID 


0 

TAG 

0 

■QH 


Figure 6-9: Option Flags Field - Identify Status Block 


TAG Tagged Queuing 

Indicates whether the firmware installed in the 
board supports tagged queuing. 

0 ^ Tagged queuing not supported. 

1 Tagged queuing supported. 
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RST Reset Jumper 

Indicates whether the SCSI bus will be reset 
at power-up and when adapter is reset 
through the reset port. 

0 SCSI bus will not be reset. 

1 SCSI bus will be reset. 

SCSI ID SCSI ID of Adapter 

Indicates the current SCSI bus ID of the 
RF3570 adapter. 

0 & Bit of ID not set. 

1 & Bit of ID set. 



SCRIPS 

7 : 

6 

lllllll 

mmSmssm 

iiiwiai 

0 

0 

0 

llillli 

0 

0 

1 

II— 

0 

1 

0 

3 ■ 

0 

1 

1 


1 

0 

0 

KHIM 

1 

0 

1 

« ill 

1 

1 

0 

mm 

1 

1 

1 


Figure 6-10: Adapter SCSI ID Bits 


Day, Month, Year 

These three fields, when combined, indicate the date (in 
hex) that the firmware in the EPROM was compiled for 
production. 


Firmware Number of Even EPROM 

There is a set of two EPROMs on the board. This number 
is the Firmware number of the EVEN EPROM. 
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Board Statistics 
(06H) 



The RF3570 adapter keeps track of several types of board 
statistics. This particular command maintains 
compatibility with earlier RF35XX products; it is used to 
report three types of statistics. The Extended Board 
Statistics command, described in a following section, 
reports additional board statistics. 

The statistics are valid only as long as power is kept to the 
system. This command reports the statistics by recording 
them in the area of system memory specified in the 
command Parameter Block. (This statistics structure is 
returned in addition to the normal Status Block.) 

You can clear the internal statistics table at any time by 
issuing the command with the CLR bit of the Options 
field set. No data transfer occurs when the CLR bit is set. 


Command The Parameter Block format for the Board Statistics 
Format command looks like this: 


Address 

mum 

By 5 ® Wamaty Address 


81111111118 



illWB 

Command Identifier | 

IIWIII 

Reserved 

Addr. Mod. 

Adapter ID = FFH| 

liSHl 

VME Memory Address 

■■■ 

Reserved 

IflH 

Command = 06 H 

Options 

Reserved | 

lillil 

Reserved 

Willi 

Reserved 


Figure 6-11: Board Statistics Command Parameter Block 


Description Each of the fields of the Parameter Block are explained 
of Fields below: 

Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must 
be a unique value. 

Adapter ID 

The Board Statistics command is a Board-control 
command. This field must be set to EFH. 
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Address Modifier 

This is the value to be used by the adapter on the Address 
Modifier lines when writing statistics to memory. This 
field is not used when the CLR bit is set. 

VME Memory Address 

This is the system memory address at which you wish to 
have the adapter place the board statistics. This field is not 
used when the CLR bit of the Options byte is set. 

Command Code 

The value for this field will always be 06H to indicate a 
Board Statistics command. 



Options 


This field has the following bit-meanings: 


| BITS 

| lllllllrlilll lllMl^lillllll 

BBHI 

j§|§§ 


imiM 

nmm 

■EM 

wmmmmmmmammm ■ 

CLR 


Figure 6-12: Bit-meanings of Statistics Options Field 


CLR This bit allows you to clear the internal 

statistic values currently stored. (Statistics 
returned by both the 06H and 16H 
commands will be cleared.) It is useful if you 
wish to keep track of statistics during a 
specific period. The only other time statistic 
values get cleared is during adapter reset. 

0 Command is used to return internal 
statistics to specified system memory 
address. 

1 ^ Command is used to clear the internal 
statistics table. VMEbus Address fields are 
not used. 

The Data Structure returned from the Board Statistics 
command is illustrated on the next page. 
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E 


Statistics Data The Statistics Data Structure returned from a Board 
Structure Statistics command will have this format: 


Addiessi 

' Byte Memory Address fill 

mmm 

mmii 


Offset * 2 : j§ 

IIlEgMIllI 

mm 

Total Commands Processed 




Total SCSI Commands Issued to ID 0 

Ittiltll 

Total SCSI Commands Issued to ID 1 

mill 

Total SCSI Commands Issued to ID 2 

11MII 

Total SCSI Commands Issued to ID 3 

MM 

Total SCSI Commands Issued to ID 4 


Total SCSI Commands Issued to ID 5 

11*1 

Total SCSI Commands Issued to ID 6 || 

Ij^pi 

Total SCSI Commands Issued to ID 7 1 

lilili 

Number of Times SCSI Check Condition Status Received | 

(Hflf 

Reserved 


iiiiwii 





Figure 6-13: Board Statistics Data Structure 


Description 
of Fields 


The Board Statistics Data Structure returned from the 
Board Statistics command contains these fields: 


Total Commands Processed 

This field reports the number of commands, SCSI 
Pass-through and Board-control, that have been processed 
by the adapter since power-up or since the CLR option 
has been used. 


Total SCSI Commands issued to an ID 

Each of these fields reports the number of commands the 
adapter has issued to the respective SCSI ID. 
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Number of SCSI Check Condition Status Received 

This field reports the number of times a SCSI device 
reported a Check Condition status. 
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General Options The General Options command allows you to select how 

(07H) the KF3570 adapter treats system and SCSI operation. The 

options you can select are general to the entire SCSI bus. 
Other options are available to you on a per unit basis with 
the Unit Options command and Extended Unit Options 
command. 



The options of this command need only be set once 
during initialization; they will remain in effect until the 
next General Options command is issued or until the 
adapter is reset. 

Command The Parameter Block for the General Options command 

Format looks like this: 


HIM 




Offset 



MilllllMlIl 

BHMI1M 

1I1B 


Command Identifier 

1 

Him 

Select Flags 

Bus Throttle 

SCSI Bus ID 

Adapter ID = FFH 

08H 


Reserved 

1 

| QCH | 

Reserved 

10H 

Command = 07H 

Reserved || 

111111 

Reserved || 



Reserved 

1 


Figure 6-14: General Options Command Parameter Block 


Description Each field of the Parameter Block is explained below: 

of Fields 


Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must be 
a unique value. 

Adapter ID 

The General Options command is a Board-control 
command. This value must be FFH. 
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SCSI Bus ID 

Each device that is connected to the SCSI bus must have 
an ID in order to communicate on the bus; the initial SCSI 
ID of the RF3570 adapter is set through jumpers. (See 
Chapter 3 for information on setting the jumpers.) 

This field of the General Options command allows you to 
select a different ID than the one jumpered for the 
adapter, without changing the jumpers. This can be useful 
to avoid conflicts caused by duplicated ID's at power-up. 

Valid values are 0 - 7H. 

You can use the Board Information command (page 6-36) to NOTE: 

find out what ID the jumpers are set to without physically 
examining the board. 



Bus Throttle 


The bus throttle control allows you to regulate the flow of 
SCSI data on the VMEbus. The flow of data is regulated 
by limiting the activity allowed by the adapter each time 
it acquires the bus. The RF3570 provides two ways to limit 
its VME bus activity. You may specify a maximum 
number of bytes to transfer for each bus acquisition or a 
maximum number of transfers to perform for each bus 
acquisition. 


| BITS 

IMilllll 

Ml 

$ i 

■ 

illlllllil 

11SI11 




B/T 

Throttle Count | 


Figure 6-15: Bit-meanings of Bus Throttle Field 


The bit-meanings of this field are as follows: 


Throttle Throttle Count 

Count The throttle count specifies either a number 
of bytes or a number of transfers, based on 
the B/T flag setting. There are specific 
ranges of values that are allowable for this 
field depending on your system bus width 
and whether you are throttling bytes or 
transfers. These ranges are given in the table 
on the next page. 
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Bus Width li Byte Count Throttle j Transfer Thmttle 

8-bit 1 to 32 lto32 

16-bit 2 to 32 lto!6 

32-bit 1 4 to 32 1 1 to 8 1 

Table 6-1: Valid Ranges of Throttle Count Values 



NOTE: If you use a value greater than the given range , the adapter will 

default to the maximum in the range. If you use zero as a value, 
it will default to the minimum. 

If you do not issue a General Options command to 
setup Throttle Count, the RF3570 defaults to Byte 
throttles and sets the throttle count to 32. 

BfT Byte or Transfer Throttle 


A Transfer Throttle counts the number of data 


transfers. Each time the adapter acquires the 
VMEbus, it will perform a number of transfers that 
is equal to or less than the transfer count value 
specified in Throttle Count. 

A Byte Count Throttle counts the number of bytes 
transferred. Each time the adapter acquires the 
VMEbus, it will transfer a number of bytes that is 
equal to or less than the byte count value specified 
in Throttle Count. 


0 ^ Transfer Count throttle method enabled; 
Throttle Count equals number of transfers. 

1 ^ Byte Count Throttle method enabled; Throttle 
Count equals number of bytes. 


Select Flags 


The Select Flags are used to determine several operating 
factors for the RF3570 adapter. One factor determined by 
Select Flags is whether the adapter will perform VMEbus 
transfers in Block Mode. Other factors pertain to the SCSI 
bus: parity checking, odd-byte handling, and 
disconnect/ reconnect. 


The format of the Select Flags byte is as follows: 
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DIS Disconnect/Reconnect 

With this bit you are able to select whether 
the RF3570 adapter will allow peripherals to 
disconnect from the SCSI bus while 
performing a command. 

0 & Disallow Disconnect/Reconnect. 

1 <=> Allow Disconnect/Reconnect. 

The default value for this bit is one — allow 
disconnects on all commands. 

PAR Check SCSI Bus Parity 

This bit allows you to select whether the 
adapter checks errors in parity that occurred 
on die SCSI bus. (The default is set by SCSI 
configuration jumpers. See Chapter 3.) 

0 o Do not check for parity. 

1 Check for SCSI parity errors. 

BMT Block Mode Transfers 

This bit allows you to set the adapter to 
operate in Block Mode. This bit affects 
transfers of data. It does not affect the transfer 
of control structures. 

0 & Data transfers will not be in Block Mode. 

1 Perform all data transfers in Block Mode 
regardless of Address Modifier used. 

The RF3570 will perform Block Mode Transfers when this bit is 
set regardless of the Address Modifier used. 

OBH Odd Byte Handling 

This bit selects how transfers with an odd 
transfer count or address will use the system 
bus. 

0 Use 8 bit system bus. 

1 ^ Use Command Interface to transfer the 
odd bytes and use the high speed DMA port 
with current system bus width for the 
remaining data. 

More information on Odd Byte Handling is 
available in Chapter 7. 


Command Code 

The command code for this command is 07H. 


E 



NOTE: 
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Un it Options (08H) The Unit Options command allows you to individually 

tailor how the RF3570 adapter operates with each SCSI 
device on the bus. 



Usually these options need be set only once, at power-up, 
to create the proper operating environment. Each unit you 
need to set-up requires a separate Unit Options command. 

Command The Parameter Block for the Unit Options command looks 
Format like this: 


1 Address 


wmm 

§§ Offsets 0 

Offset +1 


i Offset *3 || 

GQH 

Command Identifier J 

04ft 

Disconnect Timeout 

Unit SCSI ID 

Adapter ID = FFH 

08ft 

Select Timeout 

Retry Control 

Retry Limit 

1111111 

Reserved 

Reserved 

Sense Count 

Unit Flags 

■■■ 

Command = 08 H 

Reserved 

(HiM 

lilii 

Sense Byte # 
Sense Byte # 

Sense Byte # 

~ Selected Ser 

Sense Byte # 

Sense Byte # 
lS 1>J^st%yt8 # 

Sense Byte # 
Sense Byte # 


Figure 6-17: Unit Options Command Parameter Block 


Description Each of the fields of the Parameter Block are described 

of Fields below: 


Command Identifier 


This field is used if you are issuing the Unit Options 
command through the structure of a Command List. It is 
used to identify the Status block returned from the 
command. It should be a unique value. 

Adapter ID 

This command performs no action on a specific SCSI 
device. It is a Board-control command and so this field 
must be FFH. 
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Unit SCSI ID 

This field must contain a number from 0-7 representing a 
SCSI device on the bus. Do not use the RF3570 adapter 
SCSI ID you assign with the General Options command. 

Disconnect Timeout 

If you have enabled SCSI bus Disconnect /Reconnect with 
the General Options command (DIS bit of Select Flags is 
set), this field selects — for the specified unit — the 
amount of time the adapter will wait for a reconnect. If a 
reconnect does not occur within the time defined, the 
adapter will post a timeout error (1FH) in the appropriate 
command Status Block. 

The time appropriate for a disconnect depends on the 
action and the unit performing the task (seeks, rewinds, 
etc.). For this reason, the Disconnect Timeout value is 
tailored per unit with a latitude of 100 milliseconds to 
almost two hours. You may also choose the option of no 
timeout for this unit. In that case, the device or SCSI bus 
must be reset to recover from the failure. 

0 ^ No timeout occurs; SCSI bus or device must be reset 
to clear a failure. 

Each increment ^ 100 milliseconds. 


Retry Limit 

If retries are enabled in the Retry Control field, (discussed 
next) this field specifies the maximum number of retries to 
attempt before reporting an error. Once the retry limit is 
reached, the error condition reported on the last retry is 
returned in the Status Block. 

You must provide a value in this field or retries will not 
occur even if enabled (in the Retry Control field). 

The sequentially recorded nature of tape media is such that 
positioning for retries requires extra commands. For this reason , 
do not enable the retry function for SCSI tape devices. 


E 



NOTE: 
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Retry Control 


This field is used to particularize the retry operation for 
this unit. This field allows you to select the type of errors 
to retry and how they are reported. 



1. 7 

|HHM| 

■Ell 

m 

illlBl 

iiilliill 

1 

plliltf 

0 

0 

0 

RBE 

RCE 

RPE 

ISB 

INT 


Figure 6-18: Bit-meanings of Retry Control Field 


INT Issue Interrupt 

When ISB bit is set, allows you to select whether 
the adapter posts an interrupt for retry Status 
Block(s) when returned. Valid only when ISB bit is 
set. 

0 Do not interrupt for retry Status Block(s). 

1 Interrupt when retry Status Block(s) returned. 

ISB Issue Status Block 

Allows you to select that a Status Block be returned 
for each command retry performed. Enabling this 
will cause multiple Status Blocks to be returned for 
a command that requires retries. 

0 ^ Do not issue a Status Block for each retry. 

1 ^ Issue a Status Block for each retry. 

RPE Retry Parity Errors 

Allows you to retry SCSI commands that failed 
with a parity error. 

0 & Do not retry for parity errors. 

1 Retry parity errors. 

RCE Retry Command Errors 

Allows you to select whether the adapter will 
respond to a device error with a retry of the failed 
command. 

0 ^ Do not retry for device errors. 

1 Retry commands that error from the device. 

RBE Retry Bus (SCSI) Errors 

Enables retries in the event that a command fails. 

0 ^ Do not perform Bus Error retries. 

1 ^ Perform Bus Error retries. 
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Select Timeout 

According to SCSI specifications, a target must respond to 
initiator selection by asserting the BSY signal in response 
to SEL, with its ID on the bus. With this field you can 
select the amount of time that the RF3570 adapter will 
wait for response before timing out with an error. 

The select timeout period is specified in 1 millisecond 
increments. The default value is 250 (FAH), which selects 
a period of 250 milliseconds. 

The longest timeout period possible is 419 milliseconds, 
selected with a value of 419 (1A3H) Any larger value 
placed in this field will still select 419 milliseconds. 

A value of 0 will select the shortest timeout period 
possible, which is about 1 millisecond. 



Unit Flags 

The Unit Flags field of the Unit Options Parameter Block 
is where you can define command operation for the unit. 
With bit settings you can address the issues of: 
synchronous data transfer, tagged commands, and use of 
the ATN signal. 


mm 


mmmmm 

HIM 

mum 


HIM 

liliilil 


■■III 

0 


0 

0 

0 

IAT 

SYN 

| UNQ 


Figure 6-19: Unit Flags Field of Unit Options Command 


UNQ Untagged Queuing 

The SCSI-1 specification allows issue of 
multiple, simultaneous, commands to a 
target that has multiple LUN's, one 
command per LUN. This bit allows you to 
select whether the RF3570 will queue 
commands to a target with multiple LUN's. 

0 Send one command at a time to this 
target. 

1 & Queue commands to this target; it has 
multiple LUN's. 
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NOTE: If you set the TAG flag (explained below) the adapter will ignore 

the UNQ bit. Setting the TAG bit implies that you are using a 
SCSI-2 device. The UNQ bit is intended for SCSI-1 devices. 

SYN Synchronous Negotiation 

Either the initiator or the target may introduce 
negotiation for synchronous operation. How you 
set this bit determines whether the RF3570 adapter 
will attempt to negotiate with the device on the 
first command. (Even if you do not set this bit to 
allow negotiation, if the target begins negotiation, 
the adapter will respond.) 

0 ^ Do not initiate negotiation for synchronous 
data transfer. 

1 <=? Negotiate for synchronous data transfer 
during first SCSI command. 

IAT Inhibit ATN Signal 

With this bit you can select whether the adapter 
will assert the ATN signal during selection of a 
target. (Some older SCSI devices do not respond to 
the ATN signal and may stop executing commands 
if it is asserted.) Setting this bit will prevent the 
adapter from negotiating for synchronous transfers 
and SCSI-2 features. If you enable either of these 
features with this bit set, you will get errors. 

0 o ATN will be asserted. 

1 ^ ATN will not be asserted during target 
selection. 

TAG Tagged Queuing 

One of the design options offered with the SCSI-2 
specification is the capability to issue multiple 
simultaneous commands to each logical unit. If you 
have a peripheral that is designed to this 
specification, you can use this bit to tell the KF3570 
adapter to negotiate for tagged queuing. The tag 
"type" is specified in the Flags-2 field of the 
Pass-through command Parameter Block. Refer to 
Chapter 5. 

0 Tagged queuing operation not negotiated. 

1 Peripheral supports tagged queuing - negotiate 
for it. 
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Sense Count 

The RF3570 adapter automatically responds to a device 
Check Condition with a SCSI Request Sense command. 
(Unless inhibited on a per command basis with the IRS bit 
of the Flags-1 field which is embedded in the SCSI 
Pass-through command Parameter Block. See Chapter 5.) 

The Request Sense command, issued by the adapter to the 
device with the Check Condition, can garner Sense 
information of up to 256 bytes. The number returned 
depends on the number asked for in the SCSI Request 
Sense command. The Sense Count field is used to define 
the number of Sense bytes the adapter will ask for when 
automatically issuing a Request Sense command. 

Valid values for this field are 0 to 32 (20H). 

If more than 32 bytes of sequential sense information is 
requested, the count will be set to 8 and error code A1H 
will be returned. 

Otherwise, the value you place in the Sense Count field is 
used in conjunction with the Selected Sense Bytes fields. 
There are three ways you can use the Sense Count and 
Selected Sense Bytes fields to get the result you want: 

To receive the default — first eight bytes of Request Sense Data: 

• Place a zero value in Sense Count field. 

• Place zeroes in all fields of Selected Sense Bytes. 

Of To receive any eight bytes of Request Sense Data from the 
possible 256: 

• Place a zero in the Sense Count field. 

• Place a number in each of the eight fields of the 
Selected Sense Bytes, in the order desired. 

ik To receive any number of the first 32 bytes of Request Sense 
Data: 

(any number over eight will generate multiple Status Blocks for 
each Request Sense command the adapter issues.) 

• Place the number desired in the Sense Count field. 



Selected Sense Bytes fields are ignored. 
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If you wish to hand-pick more than eight bytes of Request 
Sense Data to be returned in a specific order, you must 
use the Extended Unit Options command; with it you can 
specify up to sixteen selected Request Sense bytes. 

Command Code 



The command code for this command is 08H. 

Selected Sense Bytes 

This part of the Unit Options Parameter Block is a 
combination of eight fields, each containing the byte 
number of one of 256 possible SCSI Sense bytes. These 
fields are only valid when the value of the Sense Count 
field of this command is zero. 

If the Sense Count field contains a 0 and all eight fields 
that make up the Selected Sense Bytes field are set to 0, 
the default Sense bytes are returned 

The default Sense bytes are bytes 0 to 7. Returned in a 
Status Block, they would appear as follows: 


Byte Memory Address 




IMMilllilllillll 


| Command fdantdsor 

Reserved 

SCSI Statue 

Error 

FI age f 

0 s Class/Code 

1 = Segment 

2 = SCSI Flags 

3 = Info Byte 

4 = Info Byte 

5 = Info Byte 

6 = Info Byte 

7 = Ex Length 


Figure 6-20: Default Ordering of Sense Bytes 


If the Sense Count field is set to 0, but there are non-zero 
values in the Selected Sense bytes fields, the byte numbers 
and order you define in the Selected Sense Bytes fields are 
used to return automatic Request Sense information for 
this device. 


If you define more than eight bytes to be returned as 
Sense Data, you will receive two SCSI Pass-through 
command Status Blocks. See Chapter 5 for more 
information about the format of die Status Blocks that will 
be returned. 
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Example Use of Selected Sense Bytes Fields 

In this example your device has valuable information, in 
bytes other than the first eight, that you wish to substitute: 

• Byte 12 is an Additional Sense Code. 

• Bytes 15 through 17 include additional error 
information. 

Assume bytes 16 and 17 are pointers that you wish to read 
in as a word. You will arrange them in the group of Sense 
Bytes to make this easy. 

For the example, the Sense Count field must be set to zero. 
The Selected Sense Bytes fields of the Unit Options 
command would look like this: 


f . y ^ - ’j 

Byt© Memory Address 

| Offset 

Offset* 1 



— 

Command kSierstsffer ||| 

04H 

Disconnect Timeout 

Unit SCSI \D 

Adapter ID « FFH 

08H 

Select Timeout 

Retry Control 

Retry Limit 

am 

Reserves! 

Reserved 

Sense Count = 0 

Unit. Flags 

1 10H 

Command ~ OSH 

Reserved I 

illlll 

OH (Class/Code) 

01 H (Segment) 

02H (SCSI Flags) 

03H (Info Byte) 

lllllll 

OCH (Byte 12) 

OFH (Byte 15) 

11H (Byte 17) 

10H (Byte 16) 


Figure 6-21: Example Selection of Sense Bytes 



Rimfire 3570 User’s Guide 

6-29 
































Board-control Command Reference 



Diagnostic/Self- The Diagnostic/Self-Test command duplicates most of the 

Test(09H) tests performed at power-up. You can select which tests 

will be performed. The command returns a special Status 
Block with testing results. 

This command writes test data into board memory. 



The adapter will not execute the Diagnostic/Self-Test 
command until it completes all preceding commands in 
order to avoid writing over valid data in memory. Also, 
the adapter will not accept other commands while it is 
executing Diagnostic/Self-test. When the testing is done, 
the adapter will service all pending Channel Attentions. 

Command The Parameter Block for the Diagnostic/Self-test 
Format command has this format 



Description Each field of the Diagnostic/Self-test Parameter Block is 

of Fields described below: 

Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must 
be a unique value. 
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Adapter ID 

This field identifies the type of command being issued. 
This is a Board-control command . The value in this field 
must be FFH. 


Test Flags 


This field is used to determine which of the RF3570 board 
tests will be performed. 


BITS 

1WWMI 

llillii 

1MH11 

j|ji|fii 

MM 

■■■I 


0 



PSI 

SBF 

186 

PCS 0 


Figure 6-23: Diagnostics Command Test Flags Field 


PCS PROM Checksum Test 

This test performs a checksum of all bytes 
programmed in the EPROMs, compares it to 
the checksum stored in the highest EPROM 
memory location, and reports the result in a 
Status Block. 

0 Skip the PROM Checksum test. 

1 Perform the PROM Checksum test. 

186 80186 Processor Test 

This routine verifies that the internal 
registers of the 80186 can be loaded with a 
sequence of data patterns, checks the 
arithmetic and logical data handling for 
correct results and flags, confirms that the 
program jump instructions function, plus 
verifies the 80186 can read and write 
memory. 

0 ^ Skip the 80186 Processor test. 

1 ^ Perform the 80186 Processor test. 

SBF Short Burst FIFO Test 

This test writes various data patterns to the 
Short Burst FIFO Gate Array, then reads it 
back to verify. This test is repeated for each 
SBF mode. 

0 Skip the Short Burst FIFO test. 

1 Perform the Short Burst FIFO test. 
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PSI Pipelined System Interface Test 

This test writes a variety of data patterns to the 
registers and counters of the Pipelined System 
Interface and then reads them back to verify. It also 
confirms that the address and transfer counters 
accurately reflect the proper DMA transfer mode, 
(i.e. adjusted for word or longword values). 

0 ^ Skip the Piplined System Interface test. 

1 Perform the Pipelined System Interface test. 

STT SCSI Termination Test 

This test checks for a blown SCSI termination 
power fuse and also verifies a good voltage at 
TERM PWR pin on the SCSI connector. 

0 & Skip the SCSI Termination test. 

1 ^ Perform the SCSI Termination test. 

EMX Emulex Fast SCSI chip Test 

This test writes a progression of data patterns to 
the registers and counters of the Emulex Fast SCSI 
chip, then reads each back to verify the pattern. 

0 ^ Skip the Emulex Fast SCSI chip test. 

1 ** Perform the Emulex Fast SCSI chip test. 

Command Code 

The command code for this operation is 09H. 
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The Status Block returned from the Diagnostic/Self-test Status Block 

command looks like this: Format 


iiliiS 

Offeet| 

Byte Memory Address 

Offsets | 

IHIHIIHI 


—1 

Hill 

Command 

Identifier | 

| S4H 

Reserves! 

Error 

Flags | 

W 

Reserved 

j OCH 

Reserved j 


Figure 6-24: Diagnostics Command Status Block 


The Status Block returned from a Diagnostic/Self-test Description 

command contains these fields: of Fields 


Command identifier 

The value in this field will be identical to the Parameter 
Block Value. 


Flags Byte 


This byte is used to indicate command completion.: 



ERR Error Status 


Indicates whether the command completed 
with an error. 

0 No error occurred. 

1 ^ An error occurred. 

CC Command Complete 

Indicates if the command has finished. 

0 Command not complete. 

1 ^ Command complete. 



Error 


This field contains error codes specific to the tests 
performed as well as those error codes generated from 
system and SCSI bus errors. See Appendix A. 
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SCSI Hard Reset The SCSI Hard Reset command simply asserts the reset 

(1 OH) (RST) signal on the SCSI bus. It will abort all commands 

being executed, even those being executed by devices that 
are currently disconnected. For this reason, it should only 
be used as a drastic means of recovery. 



Command The Parameter Block for the SCSI Hard Reset command 
Format has this format: 


Address 

Offset: 

Byte Memory Address jlSlIlli^liSllli 



1111111811118 


HU 

Command Identifier | 

l ill 

Reserved 

Adapter ID = FFH | 

Kllllll 

Reserved 

imu 

Reserved | 


Command = 10H 

Reserved 

Reserved 1 

1HB 

Reserved 1 

IHM Reserved 


Figure 6-26: SCSI Hard Reset Parameter Block 


Description 
of Fields 


Each field of the SCSI Hard Reset Parameter Block is 
described below: 


Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must 
be a unique value. 

Adapter ID 

This field identifies the type of command being issued. 
This is a Board-control command . The value in this field 
must be FFH. 
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Command Code 

The command code for this Board-control command is 
10H. 


6 
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Board Information 
(15H) 


This command returns a special Board Information Data 
Structure (in addition to the normal status block), that 
provides information about the current configuration of 
the RF3570 adapter. The structure, returned at the address 
you specify in the Board Information command 
Parameter Block, includes information about the options 
set with the General Options and Unit Options commands 
as well as the configuration set in the hardware. It can be 
used as a snapshot of the board set-up. Additionally, the 
same information received from the Identify command is 
included in the structure returned. 



This command can be issued with either a Single 
Command structure or in a Command List. 


Command The Parameter Block for the Board Information command 
Format has this format: 


iiiiiii 


Offset 




KIlliBlllllll 

min 

Command Identifier | 

1 Q4H 

Reserved 

Addr. Mod. 

Adapter ID = FFH 

08H 


VME Memory Address 


0CH 


Reserved 


1 tm 

Command = 15 H 

Reserved 

PPlPifl 


Reserved 


jjHB 


Reserved 



Figure 6-27: Board Information Command Parameter Block 


Description 
of Fields 


Each field of the Board Information Parameter Block is 
described below: 


Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must be 
a unique value. 
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Adapter ID 

This is a Board-control command . The value in this field 
must be FFH. 


Address Modifier 

This is the value to be used by the adapter on the Address 
Modifier lines when writing the Board Information Data 
Structure to memory. 


VME Memory Address 

This is the system memory address at which you wish to 
have the adapter place the Board Information Data 
Structure. 


Command Code 

The value for this field will always be 15H to indicate a 
Board Information command. 


The format of the Data Structure returned from the Board 
Information command is illustrated on the next page. 
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Board Information 
Data Structure 


The Data Structure returned by the Board Information 
command has two parts. The first part of the structure 
consists of a special header primarily containing General 
Board Information (including hardware configuration). 

The second part of the returned structure consists of eight 
blocks of data that describe the Unit Options set for each 
target attached to the RF3570. The first block corresponds 
to SCSI ID 0, the second to SCSI ID 1, etc. 


Each of the fields of this Data Structure are described 
below and on the following pages: 




General Board 

Information 

Header 


Per Target 
Information 


Address* 
; Offset 

Byte fltemory 


MMWMi 


BPPPMWI 

aoH 1 

FW Rev. 

Eng. Rev. 
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Select Flags 

04H 

Option Flags 

Day 
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mi 

Firmware Number of Even Prom | 

llilll 

Reserved 

SCSI Cfig Block 

Termination || 

Ijllll 

Reserved 

14H 

Sense Count 

Retry Limit 

Disconnect Timeout 

iiilll 

Synch Offset 

Synch Period 

Device Flags ! 

■■■ 

Reserved 


Sense Byte # 

Sense Byte # 

Sense Byte # 

Sens© Byte # 

1HN 

Sense Byte # 

Sense B^e # , 

. Sense Byte # 

Sens© Byte # 

llilll 

Sense Byte # 

Sens© Byte # 

Sense Byte # 

Sense Byte # 

PB11I 

Sense Byte # 

Sense Byte # 

Sense Byte # 

Sense Byte # 






FOH 

T 

s 

arget information 
aven more times 

epeated' 



Figure 6-28: Board Information Data Structure 


Description 
of Fields 


The Data Structure returned from a Board Information 
command contains the fields shown on the following 
pages. 

Select Flags 

This field displays the selections currently valid for the 
Select Flags field of the General Options command. 
The format of the Select Flags byte is as follows: 
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| BITS 

1111111 

lllttllll 

Mill 

EH 

3 

111111 

1111111 

liiiiii 

0 

0 



OBH 

BMT 

PAR 

DIS 


Figure 6-29: Board Information - Select Flags Field 


DIS Disconnect/Reconnect 

This bit indicates whether the RF3570 
adapter will allow peripherals to disconnect 
from the SCSI bus while performing a 
command. 

0 Disconnect/Reconnect is disallowed. 

1 ^ Disconnect/Reconnect is allowed. 

PAR Check SCSI Bus Parity 

This bit indicates whether the adapter 
reports errors in parity that occurred on the 
SCSI bus. 

0 ^ Parity will not be checked. 

1 ^ SCSI parity will be checked. 

BMT Block Mode Transfers 

This bit indicates whether the adapter is set 
to operate in Block Mode. This bit affects 
transfers of data. It does not affect the transfer 
of control structures. 

0 & Data transfers will not be in Block 
Mode. 

1 All data transfers occur in Block Mode 
regardless of Address Modifier used. 

OBH Odd Byte Handling 

This bit indicates how transfers with an odd 
transfer count or address will use the system 
bus. 

0 ^ 8 bit system bus is used. 

1 o Command Interface used to transfer the 
odd bytes and the high speed DMA port 
with current system bus width used for the 
remaining data. 
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Bus Throttle 

This field displays the currently selected throttle option in 
an identical manner as the field used to select throttle in 



the General Options command. 
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indicate whether a particular option is enabled or 
available in the revision of firmware installed. 


mm 


7 

& 

— 

IIHIMI 

nmm 

muni 

iiiiiiii 

•« 1 

SCSI ID 


0 

TAG 

0 



Figure 6-31 : Bit-meanings of Option Flags Field 


The bit-meanings of the Option Flags field are as follows: 

TAG Tagged Queuing 

Indicates whether the firmware installed in 
the board supports tagged queuing. 

0 Tagged queuing not supported. 

1 <=? Tagged queuing supported. 


Even if support of Tagged Queuing is indicated here, you will NOTE: 

still need to enable it with the Unit Options command to use it. 

RST Reset Jumper 

Indicates whether the SCSI bus will be reset 
at power-up and when adapter is reset 
through the reset port. 

0 SCSI bus will not be reset. 

1 c? SCSI bus will be reset. 

SCSI ID SCSI ID of Adapter 

Indicates the current ID of the adapter. 

0 Bit of ID not set. 

1 <=? Bit of ID set. 
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IIIIIIII 
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1 
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Figure 6-32: Adapter SCSI ID Bits 
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Firmware) Number of Even EPROM 

There is a set of two EPROMs on the board. This number 
is the checksum of the EVEN EPROM. 

Termination 


This field returns the status of the SCSI fuse on the RF3570 
and the condition of terminator power on the SCSI cable 
connector. It has this format: 


BITS 

— 

imm 

1111111! 

— 

3 


Mil 

SMIIB 

Ki 


0 


0 

BSF 

BTP 



Figure 6-33: Bit-meanings of Termination Field 


Bad SCSI Termination Power 

Indicates whether there is sufficient voltage on the 
TERM PWR pin of the SCSI connector. 

0 Proper 4 - 5.25 volts available. 

1 Less than 4 volts available. 

Blown SCSI Fuse 

Indicates whether the Termination Power Fuse on 
the adapter is intact. 

0 Fuse is good. 

1 Fuse is blown. 


mm 


BTP 


BSF 
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SCSI Cfig Block 

This field reports the status of the SCSI Configuration 
Block of hardware jumpers. You can use it to determine 
how the jumpers are set without removing the board from 
your system: 


■ 


MS 



illllll 

S ' 

mm 


MUM 

ilMI! 

— 

1 1 -2 

i 

CO 

5-6 

7-8 

9-10 

[ 11-12 

13-14 

15-16 


Figure 6-34: SCSI Configuration Jumpers 


Each bit corresponds to a hardware jumper. 


0 ** Jumper is not present. 

1 ^ Jumper is installed. 

The purpose for each jumper is described in the table 
below: 


IHHI 

Description 

Default 

G-L 

Reserved 

0UT 

ESI 

OUT 

1 5-6 

OUT 

00 

1 

h* 

Enable SCSI Parity Checking 

OUT = Selected 

o 

t— 

1 

o> 

SCSI bus Reset at Power-up 

OUT =Selected 

11-12 

SCSI ID Bit 2 

OUT = 0 

13-14 

SCSI ID Bit 1 

OUT = 0 

15-16 

SCSI ID BitO 

OUT = 0 1 


Table 6-2: SCSI Cfig Block - Default Jumper Settings 


Target - Disconnect Timeout 

If Disconnects are enabled for the target with the General 
Options command, this field represents the amount of 
time the adapter will wait for a reconnect before taking 
error recovery action. For more information, refer to the 
section of this chapter that explains the General Options, 
Unit Options, and Extended Unit Options commands. 
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Target - Retry Limit 

This field specifies the maximum number of retries the 
RF3570 will attempt before reporting an error. This value 
is set for each target with the Unit Options or Extended 
Unit Options command. 

Target - Sense Count 

This field reports the number of Sense bytes that the 
adapter will return for this target. This number is defined 
by the Unit Options or Extended Unit Options commands. 

Target - Device Flags 

The Device Flags field is a word wide. It reports the 
options that you have selected for this target with the Unit 
Options or Extended Unit Options command. The format 
is as shown below: 


■: bits : MMMMlWMIMIlilllli 

■1 

Hi 

1111 

ill! 

ill i 

IBS 

8 

m 

III 

MB 

111 

HI 

HI 

111 

ill 

m 


a 

RBE 

RCE 



INT 

0 

eesd 

D 

D 



UNQ 


Figure 6-35: Bit-meanings of Device Flags Field 


UNQ Untagged Queuing 

This bit indicates whether the RF3570 will queue 
commands to a target with multiple LUN's. 

0 ^ One command at a time will be sent to this 
target. 

1 o Commands to this target will be queued; it has 
multiple LUN's. 

SYN Synchronous Negotiation 

This bit indicates whether negotiations for 
synchronous transfers will be initiated for this 
target. 

0 <=> Synchronous transfer negotiation will not be 
initiated by adapter. 

1 ^ Adapter will initiate synchronous transfer 
negotiations. 
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IAT Inhibit ATN Signal 

This bit indicates if the adapter is to assert 
the ATN signal. 

0 ^ Adapter will assert ATN for this target. 

1 <=> Adapter will not assert ATN for this 
target. 

TQE Tagged Queuing Enabled 

This bit indicates whether you have enabled 
tagged queuing operation with this target. 

0 <=» Tagged Queuing is not enabled. 

1 Tagged Queuing is enabled. 

The setting of this bit indicates only that you have enabled NOTE: 

tagged queuing operation for this target using the Unit Options 
(or Extended Unit Options) command. It does not indicate that 
the device is actually operating in that mode. 

INT Issue Interrupt 

Used with the ISB bit, the INT bit indicates 
whether the adapter will post an interrupt 
for retry Status Block(s) returned for this 
target. 

0 Will not interrupt for retry Status 
Block(s). 

1 & Will interrupt when retry Status 
Block(s) returned. 

ISB Issue Status Block 

This bit indicates whether a Status Block will 
be returned for each command retry 
performed on this target. 

0 <=? Will not issue a Status block for each 
retry. 

1 Will issue a Status Block for each retry. 

RPE Retry Parity Errors 

This bit indicates whether the adapter will 
retry SCSI commands that failed with a 
parity error. 

0 Will not retry for parity errors. 

1 & Will retry parity errors. 
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RCE Retry Command Errors 

This bit indicates whether the adapter will respond 
to a device error with a retry of the failed 
command. 

0 Will not retry for device errors. 

1 & Will retry commands that error from the 
device. 

RBE Retry (SCSI) Bus Errors 

This bit indicates whether the adapter will retry a 
command that fails. 

0 ^ Will not retry SCSI Bus Errors. 

1 & Will retry commands that failed due to SCSI 
Bus Errors. 

SS Selected Sense 

This bit indicates whether you are using the 
Selected Sense byte option to return up to 16 bytes 
of specially ordered and selected Sense data. 

0 ^ Sense data defaults to first eight bytes returned 
from the device. 

1 ^ Selected Sense option in effect; Sense data 
returned according to selection. 

Target - Synch Period 

The Synchronous Transfer Period is negotiated between 
initiator and target when the target is able to operate in 
synchronous mode. The common value is agreed upon 
via Messages between initiator and target. The 
Synchronous Transfer Period is the minimum time 
allowed between leading edges of each successive REQ 
pulse and each successive ACK pulse. 

The transfer period (in nanoseconds) is calculated by 
multiplying the negotiated value by 4: 

Transfer period(nanoseconds) = negotiated value X 4 

Target - Synch Offset 

This value is negotiated between initiator and target when 
the target is able to operate in synchronous mode. The 
common value is agreed upon via Messages between 
initiator and target. The Synch Offset is the maximum 
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number of REQ pulses allowed to be outstanding before 
the corresponding ACK pulses are received. This value is 
usually a function of the buffering available on the device. 

Target - Selected Sense Bytes 

If the Selected Sense option is in effect, these 16 fields 
indicate which Sense bytes, in which order, will be 
returned from the device. 

If you have enabled 16 Selected Sense Bytes using the 
Extended Unit Options command you will receive the 
Selected Sense bytes in two Status Blocks. In that case, the 
first eight Sense byte Fields displayed in the Board 
Information Data Structure will be returned with the first 
Status Block. The last eight will appear in the second 
Status Block. 
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Extended Board The RF3560 adapter keeps track of several types of board 

Statistics ( 16 H) statistics. With the Extended Board Statistics command 

you can retrieve the extended set of statistics kept by the 
adapter. The statistics are valid only as long as power is 
kept to the system. This command reports the statistics by 
recording them in the area of system memory specified in 
the command Parameter Block. This statistics structure is 
returned in addition to the normal Status Block. 

You can clear the internal statistics table at any time by 
issuing the command with the CLR bit of the Options 
field set. No data transfer occurs when the CLR bit is set. 


Command The Parameter Block format for the Extended Board 
Format Statistics command looks like this: 



HUi 

Offset ; 






■HI 

Command 

Identifier | 

mm 

Reserved 

Addr. Mod. 

Adapter ID = FFH 

iiiiii 

VME Memory Address 

lilll 

Reserved 

111 

Command = 16 H 

Options 

Reserved 

iSil 

Reserved 

Reserved 


Figure 6-36: Extended Board Statistics Parameter Block 


Description Each of the fields of the Parameter Block are explained 

of Fields below: 

Command identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must be 
a unique value. 

Adapter ID 

The Extended Board Statistics command is a 
Board-control command. This field must be set to FFH. 
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Address Modifier 

This is the value to be used by the adapter on the Address 
Modifier lines when writing extended statistics to 
memory. This field is not used when the CLR bit is set. 

VME Memory Address 

This is the system memory address at which you wish to 
have the adapter place the Extended Statistics Data 
Structure. This field is not used when the CLR bit is set. 

Options 


The options field is one byte wide with the following 
format and bit-meanings: 


bits — 


iUlM 

imwii 

iiMim 


2 


llllllS 

0 

CLR 


Figure 6-37: Extended Board Statistics Options Field 


CLR This bit allows you to clear the internal 

statistic values currently stored. (Statistics 
returned by both the 06H and 16H 
commands will be cleared.) It is useful if you 
wish to keep track of statistics during a 
specific period. The only other time statistic 
values get cleared is during adapter reset. 

0 & Command is used to return internal 
statistics to specified system memory 
address. 

1 Command is used to clear the internal 
statistics table. 



Command Code 

The value for this field will always be 16H to indicate an 
Extended Board Statistics command. 

The format of the Extended Data Structure returned from 
the Extended Board Statistics command is illustrated on 
the next page. 
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Extended Statistics The Extended Statistics Data Structure returned from an 
Data Structure Extended Board Statistics command will have this format: 



Total Commands Issued 


This field reports the number of commands, SCSI 
Pass-through and Board-control, that have been processed 
by the adapter since power-up, reset, or the CLR bit 
option was used. 

Number of SCSI Bad Status Conditions 

This field reports the number of times a status other than 
Good was reported by all SCSI devices. 

Number of SCSI Parity Errors 

This field reports the total number of SCSI Parity Errors 
that have occurred since power-up, reset, or the CLR bit 
option was used. 
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Per SCSI Target — Number of Commands 

This field is repeated for each of the eight possible SCSI 
Target ID's. It reports the number of commands received 
by that target since power-up, reset, or the CLR bit option 
was used. 


Per SCSI Target — Queue Full Count 

This field reports the number of times a target reported a 
Queue Full status. It may be useful in evaluating the 
performance of tagged queuing operation with a SCSI-2 
target. 


Per SCSI Target — Maximum Queued 

This field reports the maximum number of commands 
that were queued to a target and may also be useful in 
evaluating the performance of SCSI-2 tagged queuing 
operation. 



Rimfire 3570 User’s Guide 

6-51 




Board-control Command Reference 



Extended Unit This command is designed as an enhancement to the Unit 

Options ( 18 H) Options command. The primary difference between the 

commands is the opportunity to select 16 bytes of Sense 
Data to be returned per unit, instead of the eight offered 
in the Unit Options command. 

Another difference is that the Extended Unit Options for 
the SCSI device are built into a Data Structure whose 
address is simply passed in the command. 


Command The format of the Extended Unit Options command is as 
Format follows: 



Description Each of the fields of the Parameter Block are described 

of Fields below: 


Command Identifier 

The Command Identifier field is used to identify the 
Status Block associated with a Parameter Block. It must be 
a unique value. 

Adapter ID 

This is a Board-control command. The value in this field 
must be FFH. 
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Address Modifier 

This is the value to be used by the adapter on the Address 
Modifier lines when reading the Extended Unit Options 
Data Structure from memory. 


VME Memory Address 

This is the system memory address at which you have 
built the Extended Unit Options Data Structure. 

Command Code 

The value for this field will always be 18H to indicate a 
Extended Unit Options command. 


The format of the Data Structure to be used for the 
Extended Unit Options command is illustrated on the 
following pages. 
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E 


Extended The Data Structure that you will use to pass the Extended 

Unit Options Unit Option parameters to the RF3570 adapter is similar 
Data Structure to the format of the Unit Options Parameter Block. 



The Data Structure must contain these fields: 


Address 

Offset 

Byte Memory Address J 

Status 


1 Offset +1 

. Offset + 2 

iiaiiii 

GOH 

Disconnect Timeout 

Unit SCSI ID 

0 

llllpll 

Select Timeout 

Retry Control 

Retry Limit 

OSH 

Reserved 

Reserved 

Sense Count 

Unit Flags 

MRi 

Sense Byte # 

Sense Byte # 

Sense Byte # 

Sense Byte # 

lllil 

Sense Byte # 

Sense Byte # 

Sense Byte # 

Sense Byte # 

* “Block #1 
Status 

IlH! 

Sense Byte # 


e %$^ie Byte # 

Sense Byte # 

liljjlil 

Sense Byte # 

Sense Byte # 

Sense Byte # 

Sense Byte # 

““Block #2 

lllil 

0 1 

Figure 6-40: Extended Unit Options Data Structure 


Description 
of Fields 


Each of the fields of the Data Structure are described 
below: 


Unit SCSI ID 


This field must contain a number from 0-7 representing a 
SCSI Unit on the bus. Do not use the RF3570 adapter SCSI 
ID you assign with the General Options command. (If you 
do you will receive the 02H (Bad Unit) error code.) 

Disconnect Timeout 

If you have enabled SCSI bus Disconnect with the General 
Options command, this field selects — for the specified 
unit — the amount of time the adapter will wait for a 
reconnect. If a reconnect does not occur within the time 
defined, the adapter will post a timeout error (1FH) in the 
appropriate command Status Block. 
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tailored per unit with a latitude of 100 milliseconds to 
almost two hours. You may also choose the option of no 
timeout for this unit. In that case, the device or SCSI bus 
must be reset to recover from the failure. 

0 <=> No timeout occurs; SCSI bus or device must be reset 
to clear a failure. 

Each increment ^ 100 milliseconds. 


Retry Limit 

If retries are enabled in the Retry Control field, (discussed 
next) this field specifies the maximum number of retries to 
attempt before reporting an error. Once the retry limit is 
reached, the error condition reported with the last retry is 
returned in the Status Block. 

You must provide a value in this field or retries will not 
occur even if enabled (in the Retry Control field). 

The sequentially recorded nature of tape media is such that NOTE: 

positioning for retries requires extra commands. For this reason, 
do not enable the retry function for SCSI tape devices. 

Retry Control 


This field is used to particularize the retry operation for 
this unit. This field allows you to select the type of errors 
to retry and how they are reported. 



When ISB bit is set, allows you to select 
whether the adapter posts an interrupt for 
retry Status Block(s) when returned. Valid 
only when ISB is set. 

0 & Do not interrupt for retry Status Block(s). 

1 <=? Interrupt when retry Status Block(s) 
returned. 
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ISB Issue Status Block 

Allows you to select that a Status Block be returned 
for each command retry performed. Enabling this 
will cause multiple Status Blocks to be returned for 
a command that requires retries. 

0 ^ Do not issue a Status Block for each retry. 

1 ^ Issue a Status Block for each retry. 

RPE Retry Parity Errors 

Allows retries of SCSI commands that failed with a 
parity error. 

0 ^ Do not retry for parity errors. 

1 Retry parity errors. 

RCE Retry Command Errors 

Allows you to select whether the adapter will 
respond to a device error with a retry of the failed 
command. 

0 o Do not retry for device errors. 

1 ^ Retry commands returning bad SCSI status. 

RBE Retry Bus (SCSI) Errors 

Enables retries in the event that a command fails. 

0 o Do not perform Bus Error retries. 

1 Perform Bus Error retries. 

Select Timeout 

According to SCSI specifications, a target must respond to 
initiator selection by asserting the BSY signal in response 
to SEL, with its ID on the bus. With this field you can 
select the amount of time that the RF3570 adapter will 
wait for response before timing out with an error. 

The Select Timeout period is specified in increments of 1 
millisecond. The default value is 250 (FAH), which selects 
a period of 250 milliseconds. 

The longest timeout period possible is 419 milliseconds, 
selected with a value of 419 (1 A1H). Any larger value 
placed in this field will still select 419 milliseconds. 

A value of 0 will select the shortest timeout period 
possible, which is about 1 millisecond. 
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Unit Flags 


The Unit Flags field of the Extended Unit Options 
Parameter Block is where you can define command 
operation for the unit. With bit settings you can address 
the issues of: synchronous data transfer, tagged 
commands, and use of ATN signal. 



UNQ Untagged Queueing 

The SCSI-1 specification allows issue of 
multiple, simultaneous, commands to a 
target that has multiple LUN's, one 
command per LUN. This bit allows you to 
select whether the RF3570 will queue 
commands to a target with multiple LUN's. 

0 <=» Send one command at a time to this 
target. 

1 < 5 * Queue commands to this target; it has 
multiple LUN's. 

If you set the TAG flag (explained on next page) the adapter NOTE: 

will ignore the UNQ bit. Setting the TAG bit implies that you 
are using a SCSI-2 device. The UNQ bit is intended for SCSI-1 
devices. 

SYN Synchronous Negotiation 

Either the initiator or the target may 
introduce negotiation for synchronous 
operation. How you set this bit determines 
whether the RF3570 adapter will attempt to 
negotiate with the device on the first 
command. Even if you do not set this bit to 
allow negotiation, if the target begins 
negotiation, the adapter will respond. 

0 & Do not initiate negotiation for 
synchronous data transfer. 

1 ^ Negotiate for synchronous data transfer 
during first command. 
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IAT Inhibit ATN Signal 

With this bit you can select whether the adapter 
will assert the ATN signal during selection of a 
target. (Some older SCSI devices do not respond to 
the ATN signal and may stop executing if it is 
asserted.) Setting this bit will prevent the adapter 
from negotiating for synchronous transfers and 
SCSI-2 features. If you enable either of these 
features with this bit set, you will get errors. 

0 «=> ATN will be asserted. 

1 & ATN will not be asserted during target 
selection. 

TAG Tagged Commands 

One of the design options offered with the SCSI-2 
specification is the capability to issue multiple 
simultaneous commands to each logical unit. If you 
have a peripheral that is designed to this 
specification, you can use this bit to tell the RF3570 
adapter to negotiate for queued tagged commands. 
The tag "type" is specified in the Flags-2 field of 
the Pass-through command Parameter Block. Refer 
to Chapter 5. 

0 ^ Tagged commands not negotiated. 

1 Peripheral supports tagged commands - 
negotiate for it. 

Sense Count 

The RF3570 adapter automatically responds to a device 
Check Condition with a SCSI Request Sense command. 
(Unless inhibited on a per command basis with the IRS bit 
of the Flags-1 field which is embedded in the SCSI 
Pass-through command Parameter Block. See Chapter 5.) 

The Request Sense command, issued by the adapter to the 
device with the Check Condition, can gamer Sense 
information of up to 256 bytes. The number returned 
depends on the number asked for in the SCSI Request 
Sense command that is issued by the adapter. The Sense 
Count field is used to define the number of Sense bytes 
the adapter will ask for when automatically issuing a 
Request Sense command. 

Valid values for this field are 0 to 32 (20H). 
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If more than 32 bytes of sequential sense information is 
requested, the count will be set to 8 and error code A1H 
will be returned. 

Otherwise, the value you place in the Sense Count field is 
used in conjunction with the Selected Sense Bytes Fields. 
There are three ways you can use the Sense Count and 
Selected Sense Bytes fields to get the result you want: 

ik To receive the default — first eight bytes of Request Sense Data: 

• Place a zero value in Sense Count field. 

• Place zeroes in all fields of Selected Sense Bytes. 

ik To receive any sixteen bytes of Request Sense Data from the 
possible 256: 

• Place a zero in the Sense Count field. 

• Place the Sense Byte number in each of the sixteen 
fields of the Selected Sense Bytes, in the order desired. 

ik To receive any number of the first 32 bytes of Request Sense 
Data (any number over eight will generate multiple Status 
Blocks for each Request Sense command the adapter issues.): 

• Place the number desired in the Sense Count field. 

• Selected Sense Bytes fields are ignored. 

Selected Sense Bytes 

This part of the Extended Unit Options Parameter Block is 
a combination of sixteen fields, each containing the byte 
number of one of 256 possible SCSI Sense bytes. These 
fields are only valid when the value of the Sense Count 
field of the Data Structure is zero. 

If the Sense Count field contains a 0 and all sixteen fields 
that make up the Selected Sense Bytes section of the Data 
Structure are set to 0, the default of eight Sense bytes is 
returned. 
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The eight default Sense bytes are displayed as follows: 


lllll Byte Memory Address 





j Command Identifier 

Reserved 

SCSI Statue 

Error 

Flags 

0 = Class/Code 

1 = Segment 

2 = SCSI Flags 

3 = Info Byte 

4 = Info Byte 

5 = Info Byte 

6 = Info Byte 

7 = Ex Length | 


Figure 6-43: Default Ordering of Sense Bytes 



If the Sense Count field is set to 0, but there are non-zero 
values in the Selected Sense bytes fields, the byte numbers 

and order you define in the Selected Sense Bytes fields are 
used to return automatic Request Sense information for 
this device. 

If you define more than eight bytes to be returned as 
Sense Data, you will receive two SCSI Pass-through 
command Status Blocks. 

See Chapter 5 for more information about the format of 
the Status Blocks that will be returned. 
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Chapter 7 — Details of Usage 

The previous chapters informed you about the details you 
will need to install the board, set up command structures, 
and issue commands to the board and the peripherals 
attached to it. This chapter will provide information you 
can use to make decisions about how the KF3570 adapter 
can be used in your system. It explains in detail how and 
why to use some of the features of the adapter. 

This chapter explains how to use the following operations 
for the RF3570 adapter: 

• Byte and Word swapping of data and command 
structures. 

• Scatter/ Gather operation. 

• Odd Byte Handling. 

• Tagged Queuing. 

This chapter is useful to use as you are making decisions 
about your system and set-up. 


Introduction 


Summary 
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Byte and Word The RF3570 adapter is flexible enough to allow you to 

Swap ping request Byte Swapping, Word Swapping or both, during 

transfers of data structures, command structures or both. 


This section will first give you some examples to explain 
why the swapping feature is offered to you, then provide 
a perspective on implementation with title RF3570 for both 
Command Structures (used by the RF3570) and data. 

Need for The memory architecture of your system depends on the 
Swapping type of processor you are using. There are several major 
manufacturers that each use different arrangements of 
bytes, words, and double-words in memory. The two 
most common formats are: Intel and Motorola. Their 
differences are illustrated in the example below: 


Example of Memory Differences 

If you were to define the following variables in a program: 


char byte[ ] = "test"; 

int word[2] = {0x0102, 0x0304}; 

double dword = OxAABBCCDD; 

They would appear this way in memory (beginning at 
location n ) for each respective format: 


: variable j | Intel Order 

| Motorola Order 

| byte 

n 

t 

e 

S 

t 

t 

e 

s 

t 

word 

n + 4 

02 

01 

04 

03 

01 

02 

03 

04 

| dword 

n + 8 

DD 

cc 

BB 

AA 

AA 

BB 

CC 

DD 


Figure 7-1: Variations in Intel and Motorola Memory 


Essentially the two processors store a string of bytes in the 
same order. However, the bytes that make up word and 
double-word information are stored in an order opposite to 
each other: 
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lliilis&f liiiil 



Motorola 

LSB* 

stored in highest memory address 

MSB* 

stored in lowest memory address 

Intel 

LSB 

stored in lowest memory address 

MSB 

stored in highest memory address 


* LSB = Least Significant Byte of a word or double-word value 

* MSB = Most Significant Byte of a word or double-word value 


Figure 7-2: Explanation of Memory Storage Differences 


There are two types of information stored in system 
memory that the RF3570 adapter must correctly access: 
Command Structures and Data. 

Throughout this manual, the Parameter and Status Blocks 
that make up the command structures are represented 
double-word wide, in Motorola ordering. 

If you have an Intel processor, you will need to translate 
these displays to your format. The following example will 
help explain this. 


Example Pass-through Command 

The information on the following page would be required 
to complete a parameter block that issues a SCSI 
Pass-through command. The example shown on the next 
page uses: 

• Logical block size is 128 bytes per block. 

• Extended Write SCSI command. 

• Command issued to LUN 1 of Target 2. 

• Transferring data from VME memory address 
5A9320H. 

• Transferring data to Logical block 8F4E9H on the 
device. 

• Parameter Block written to memory address 89FF4H. 
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Example parameters for a Pass-through command: 


Name of Parameter Block 
field 

Value used for 
example 

Comments 

Command Identifier 

04030201H 


Target ID 

Q2H 


Address Modifier 

3EH 


Flags-1 

86H 


Flags-2 

01H 


VME Memory Address 

005A9320H 


Transfer Count 

00010280H 


SCSI Command Byte 0 

2AH 

Extended Write Command 

SCSI Command Byte 1 

40H 

Logical Unit 1 

SCSI Command Byte 2 

00H 

Logical Block Address (MSB) 

SCSI Command Byte 3 

08H 

Logical Block Address 

SCSI Command Byte 4 

F4H 

Logical Block Address 

SCSI Command Byte 5 

E9H 

Logical Block Address (LSB) 

SCSI Command Byte 6 

00 

Reserved 

SCSI Command Byte 7 

02H 

Transfer Count (MSB) 

SCSI Command Byte 8 

05H 

Transfer Count (LSB) 

SCSI Command Byte 9 

00 

Control Byte 

SCSI Command Byte 10 

00 

Not Used 

SCSI Command Byte 11 

00 

Not Used 


If written to VME memory in the order given above, these 
command parameters would be written differently (as 
shown below) for both types of processors: 


Intel Ordering 


Motorola Ordering 


89FF4 

01 

. 02 

03 

mm 

89FF8 

02 

3E 

86 

01 

89FFC 

lllllll 

93 

5A 

' 00 

8 AO 00 

80 

02 

llllll 

00 

8A004 

08 

00 

40 

2A 

iilllllll 

: 02 

00 

£9 

1111; 

iiiiiii 

00 

oo: f 

llllll 

|i|il 




89FF4 ■ 

04 

03 

02 

01 1 

89FF8 

llllllll 

86 | 

3K 

02 

89FFC 

00 

5A 

93 

llllll 

8AOOO 

00 

llllll 

02 

80 

8A004 

II 2A 

40 

00 

08 

8A008 

F4 

£9 

lllllll! 

02 ' 

8AOOC ; : 

• 05 

00 

00 

00 


Figure 7-3: Intel versus Motorola Ordering 
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It becomes apparent when examining the memory 
displays, that the Command Structures of the RF3570 
though divided into a variety of byte, word, and 
double-word fields, must be considered as a grouping of 
double-words. 

In a Motorola environment, the Parameter Block would 
remain as graphically represented throughout this 
manual, and as shown below: 


[Address!; 

Byte Memory Address 

Offset ' 

Offset* 0 

ilMlSgjllll 

iBBHHi 

Offset +3. | 

llliill 

Command Identifier = 04030201 H 

llillli 

Flags-2 = 01 H 

Flags-1 = 86H 

Addr. Mod = 3EH 

Target ID = 02H | 

11 

VME Memory Address = 005A9320H 

MIBI 

Transfer Count = 0001 0280 H 

j 10H -j 

0 = 2AH 

1 = 40H 

2 = 0 

3 = 08H 


4 = F4H 

5 = E9H 

6 = 0 

7 = 02H 

lH|| 

8 = 05H 

9 = 0 

10 = 0 

11 =0 


Figure 7-4: Motorola Ordered Parameter Block 


However, if you have an Intel processor, you must 
reinterpret the representations in this manual to an order 
like this: 


Address 

Offset 

Mommy Address 

Offset* 3^ | 

IMMlllllBl 


llillli 

^Coirfi!tand-lde^ffier^04Q30201H^\\ \ 

04B 

Flags-2 = 01 H 

Flags-1 = 86H 

AddnMod^EH 

rfefget]pV02t[ 

| OBlf \ 

VME Memory Address = 005A9320H 

liliMii 

Transfer Count = 00010280H 

/m i 

0 = 2AH 

1 = 40H 

2 = 0 

3 = 08H 


4 = F4H 

5 = E9H 

6 = 0 

7 = 02H 

llillli 

8 = 05H 

9 = 0 

10 = 0 

11 =0 


Figure 7-5: Intel Ordered Parameter Block 


Offset + x 
values are 
in opposite 
order for 
Intel 

processors 
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In order for this transition to properly occur, more than 
just your interpretation of the graphics in the manual 
must change. The RF3570 must be told to also reinterpret 
the structures it uses. 

RF3570 Byte and Word Swapping methodology for the RF3570 
Swapping Options adapter is configured with the Control field of the 

Address Buffer Port. This field is in the first word written 
to the Address Buffer Port. (For bit-specific information 
on the Address Buffer Port see Chapter 2, Hardware 
Essentials.) 

Swapping is a function of the hardware on the RF3570 
adapter and is enabled and performed without detriment 
to performance. 

There are four bits in the Control field that allow you to 
separately control byte swapping and word swapping — 

2 bits for Command Structures and 2 bits for data to be 
transferred. If you set none of the swapping bits in the 
Control field, the Command Structures and the data will 
be ordered for a standard Motorola processor. 

Command Structure Swapping 

As explained, the need to byte-swap and word-swap the 
fields of the RF3570 Command Structures is due to the 
differences inherent in various processor architectures. 
Since the KF3570 defaults to using Motorola ordering for 
its structures, if your system uses a Motorola processor, 
no byte and word swapping is necessary. However, if 
your system uses an Intel processor, the Command 
Structures of the RF3570 must be adjusted. 

This could be done entirely in software — the Host 
processor could re-order the Command Structures. 
However this extra burden for the system is not necessary 
because, by simply enabling the Byte and Word Swap 
controls, the RF3570 hardware will automatically re-order 
the Command Structures. The re-ordering occurs at "no 
cost" since the hardware automatically performs this 
feature with no additional overhead. 
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Data Swapping Options 

Another aspect of the Byte and Word swapping ability of 
the RF3570 is for conversion of the format with which 
data is written to media. 

The demonstrated difference in memory ordering 
between Intel and Motorola for Command Structures can 
be equally valid for data transfers. Since most data 
transfers will naturally occur using the full bus width 
available, the issue again becomes the difference in the 
way words and double-words are stored in memory (and 
then transferred to media). 

This is only important if you are sharing data between 
two different types of processors. 


Sharing Tapes 

For example, if you are writing tapes with an Intel-based 
machine and only Intel-based machines will be reading 
them, no swapping is necessary. 

If, however, a Motorola-based machine was to read the 
tape, it may need to re-order the data. Again, this could be 
done in software by having the Motorola processor 
re-order the data structures. Again, with the RF3570 it is 
not necessary to burden the Host processor. 

By simply enabling the Byte and Word Swap controls, the 
RF3570 adapter hardware will automatically re-order the 
data structures with no additional overhead. 


Dual Initiators 

Another case for data swapping would be when dual 
RF3570's are used in separate machines but share the 
same SCSI bus. If both systems use the same disk media, 
and each is based on a different processor, one of the 
RF3570's may need to have swapping enabled. 
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Implementation of Data swapping 

To accomplish Byte and Word swapping conversion for a 
data transfer, the WSD and/or the BSD bits of the Control 
field of the Address Buffer Port must be set to 1. 

(See Chapter 2 for more information about the Address 
Buffer Port.) 

NOTE: If you set the WID bit of the Control field to 2, you will enable 

32-bit data transfers and will need to sway both words and 
bytes. If you set it to 0, 16 bit transfers will occur and you will 
only need to setup for byte swapping. 

The use of Byte and Word swapping for data transfers can 
easily be used to provide flexibility for your system. 

Follow these guidelines to make it work for you properly: 

1 -) If you enable byte-swapping, you must be sure that 
all system addresses and transfer counts that you use 
are aligned to a word boundary. If you do not, byte 
swapping will not be performed even if you set the 
proper bit. 

For the RF3570 to know which bytes to properly 
swap, it must have a point of orientation to work 
from. Therefore you must arrange addresses and 
counts to preserve the word boundary. 

2.) If you enable word-swapping, you must align all 
system addresses and transfer counts to a double- 
word boundary. If you do not, word swapping will 
not be performed even if enabled. 

Again, the RF3570 requires proper address orienta- 
tion and proper byte counts to be able to judiciously 
swap words. 
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3.) You may need to allocate more memory for a transfer 
or adjust the counts you use in order to accomodate 
the need to preserve word or double-word bounda- 
ries. This may require an additional routine in your 
driver that checks addresses returned from dynamic 
allocation. 
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Scatter/Gather 

Operations 


What it does 


How to use 
Scatter/Gather 


Usage 


The Scatter/Gather feature is an alternate means to utilize 
the memory space available in your system. It can be 
enabled, for any command that transfers data to or from a 
SCSI device, by setting a bit in the Pass-through 
Parameter Block of the command. 

Briefly, Scatter /Gather operations allow more flexibility 
in allocating memory space for your transfers. With 
Scatter/Gather enabled a single command can: 

• Use separate pieces of memory. (Pieces that are 
non-contiguous, non-adjacent, not next to each 
other.) 

• Use pieces of memory that are sized smaller than the 
block size of the command. 

Scatter/ Gather Operations (SGO) must be enabled and 
set-up properly. Each step in the process is explained 
briefly below. 

1. Build a chain of Descriptor Blocks that contain pointers 
to locations in memory that you wish to use. Each SGO 
Descriptor Block defines up to eight segments of memory 
by providing the address and length of each segment. 

To build the chain: 

a. ) Build each Block in memory. Up to eight segments can 
be described in each block; provide the address and length 
of each segment. 

b. ) Point to the first Descriptor Block from the VME 
Memory Address field of the Parameter Block issuing the 
command. 

c. ) Place the address for each subsequent Descriptor Block 
in the first double-word of the current Descriptor Block. 

d. ) Identify the last Descriptor Block by placing an end 
value (FFFFFFFFH) in its first double-word. 

2. Set the SGO bit in the Flags-1 byte to a one in the SCSI 
Pass-through Parameter block containing the command. 
(See page 5-3 for more information.) 

3. Issue the command using the normal means. 
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The Descriptor Block is an important piece of the Format of 

Scatter/ Gather operation. Each must be set up in the Scatter/Gather 

format that follows: Descriptor Block 


Slii 

mfmsm 

| Byte Memory Address 

Offset + 0 

Offset *1 Offset *2 Offset* 3 

IBM 

Next SG Descriptor Block Address | 

: MH 

Add Mod 1 

Data Length - Segment 1 J 

OSH 

Data Address -Segment 1 

111!!!! 

Add Mod 2 

Data Length - Segment 2 

IHMi 

Data Address - Segment 2 

14H 

Add Mod 3 

Data Length - Segment 3 | 

Illllillll Data Address - Segment 3 | 

lOH 

Add Mod 4 

Data Length - Segment 4 jj 

limn 

Data Address - Segment 4 |i 

zm 

Add Mod 5 

Data Length - Segment 5 

11111 

Data Address - Segment 5 

2CH 

Add Mod 6 

Data Length - Segment 6 

mm 

Data Address - Segment 6 

Add Mod 7 

Data Length - Segment 7 

mpi 

Data Address - Segment 7 

wm 

Add Mod 8 

Data Length - Segment 8 | 

IBHI 

Data Address - Segment 8 


Figure 7-6: Scatter/Gather Descriptor Block 


Next SG Descriptor Block Address 

This field is used to point to other Scatter/ Gather 
descriptor blocks in the series or to indicate that this block 
is the last in the series. 

Valid Address = Next Block Address. 
FFFFFFFFH = This is the last descriptor 
block (of memory segments) in the series. 

Address Modifier - # 


For each of the eight segments of the Descriptor Block you 
will need to provide the Address Modifier value to be 
used for the transfer. 
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Data Length - Segment # 

With this field you indicate, for each of the eight 
segments, the number of bytes available at the indicated 
address in memory. This field is also used to indicate 
when there are no more segments used in this block. 

Valid number = Number of bytes available at 
memory location. 

0 = There are no more segments used in this block. 

Data Address - Segment # 

This field indicates the beginning address of the segment 
for each of the eight segments in the SGO Descriptor 
Block. 

How Scatter/Gather is When you issue a Read or Write command to the RF3570 
Performed adapter with the SGO bit of the Flags byte set to one, the 

adapter expects a Scatter /Gather operation. The adapter 
follows this sequence: 

1 . At the address, specified in the Pass-through command 
Parameter Block the adapter reads in the first SGO De- 
scriptor Block 

2. Beginning at the Data Address - Segment 1 of the block, 
the adapter transfers data (Read or Write) until the Data 
Length - Segment 1 count is reached. 

3. The Data Length of the next segment indicated in the SGO 
Descriptor block is examined for a zero value. If there is a 
non-zero value, the adapter continues the transfer opera- 
tion, at the next segment address, until the next segment 
Data Length is exhausted. 

4. This process continues until a zero Data Length is reached, 
or the limit of eight segments is reached. The adapter then 
reads in the next SGO Descriptor block The address of the 
next block is read from the Next SGO Descriptor Block 
Address field. 

5 Steps 2, 3, and 4 are repeated for each SGO Descriptor 
Block 

6 . The Scatter /Gather operation is terminated when the 
adapter identifies a value of FFFFFFFFH in the Next SGO 
Descriptor Block Address field. 
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These are the things to remember as you are using the 

Scatter/Gather feature offered by the RF3570 adapter: 

• The RF3570 always reads the entire Descriptor Block, 
regardless of the number of segments that are actually 
used. You do not have to use all eight segments 
available in a single SGO block — indicating a zero in 
the Data Length field of any segment causes 
subsequent segments to be ignored during processing 
of the block. It is to your benefit to use all the segments 
of a block rather than have more blocks because each 
new block read by the adapter requires a bus transfer. 
Therefore more VMEbus activity is incurred if the 
blocks are mostly empty. 

• You should build all SGO blocks before issuing the 
command that will use them. This will prevent the 
adapter from being given invalid parameters. 

• To maximize performance when using Scatter/ Gather 
you should be sure that the Data Length and Data 
Address of all segments in a Descriptor Block cause 
alignment to the same byte /word/ double-word 
boundary. The RF3570 hardware design incorporates 
proprietary VLSI that preloads the starting address 
and transfer count of the next segment in the 
Descriptor Block. This pipelining is only effective 
when all the segments in a single Descriptor Block are 
aligned to the same address boundary. 

• The transfer count in the Parameter Block should 
contain a value that reflects the total number of bytes 
to be transferred in the entire SGO operation. 

• All other fields of the Pass-through Command 
Parameter Block are used the same as in a non-SGO 
operation. 


E 

Notes on Use 
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Example In this example, two Descriptor Blocks are used to define 
Scatter/Gather eleven areas of memory that together contain 400H bytes 
Operation of information to be written to SCSI device zero. 


The example Parameter Block for this Gather Write 
command contains this information: 


The SGO bit 
of this field 
must be set 
to 1. 


This is the 
address of 
the first SGO 
Descriptor 
Block. 


Address 

smut 

' Byte Memory Address 




iilifcii 

Command Identifier = 00001 A84H [ 

■■■ 

Flags-2 = 00iT 

Flags-1 = 01 H 

Addr. Mod =3DH 

Target ID = 00H 

|HHi 

VME Memory Address = 00345678H 1 

1HM 

^ z Transfer Count = 00000400H [ 

IMliMllI 

0 = 2AH/ 

1 = 40H 

2 = 0 

3 = 08H 


4=JF4H 

5 = E9H 

6 = 0 

7 = 00H 



9 = 0 

10 = 0 

11 =0 





gure 7-7: Example Scatter/Gather Parameter Block 


The Transfer 
Count should 
be the total of 
all Descriptor 
Block transfers. 


Address Modifiers, Segments 1-8 


Follow these steps to issue the Scatter/Gather command. 

1 .) Build a Chain of Descriptor Blocks. 

For this example, two blocks will be built, the first is at the 
address specified in the Parameter Block — 345678H: 



Next SG Descriptor Block Address 


Data Length 
Data Address 

| Segment 1 


| Segment 2 


| Segment3 


| Segment 4 


| Segment 5 

Data Length 
Data Address 

| Segment 6 


| Segment 7 

Data Length 
Data Address 

1 Segment8 



Figure 7-8: First SG Descriptor Block 
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The next Descriptor Block is at the address specified in the 
Next SG Descriptor Block Address field of the first 
Decriptor block — 233334H: 


Address Modifiers, Segments 1-8 



Next SG Descriptor Block Address 


Data Length 
Data Address 

Segment 1 


Segment 2 


Segment 3 


Segment 4 

Data Length 
Data Address 

Segment 5 

Data Length 
Data Address 

Segment 6 

Data Length 
Data Address 

Segment 7 

Data Length 
Data Address 

Segment 8 



Figure 7-9: Last SG Descriptor Block 


Note that this Descriptor Block has the value FFFFFFFFH 
in the first field to indicate that this is the last Descriptor 
Block. Additionally, only three of the eight segments are 
used in this Descriptor Block; the rest of the segments are 
zeroed. 

2. ) Be sure the SGO bit of the Parameter Block is set to 

one. 

3. ) The command is ready to be issued. 
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Odd Byte Handling The highest throughput and least amount of overhead is 

acomplished during data transfers by: aligning all 
memory addresses to an even boundary of the system bus 
width, and using transfer counts divisible by the number 
of bytes in the system bus width. This allows the adapter 
to always transfer data using the full width of the system 
bus. Although desirable, this may not always be possible. 
When not possible, the RF3570 must decide how much of 
the available bus it can use for the transfer. The Odd Byte 
Handling feature of the RF3570 is an alternate algorithm 
for determining transfer width that attempts to mitigate 
effects on performance when the address and/ or transfer 
count used in a command are not aligned. 

The RF3570 can be set-up to use either the Standard or 
Odd Byte Handling algorithm for determining transfer 
width. Each method has trade-offs. Which one you choose 
should be decided based on the types of transfers typical 
to your system and availability of bus resources. The Odd 
Byte Handling feature must be enabled using the General 
Options Board-control command. (See Chapter 6 for more 
information.) The RF3570 defaults to the Standard 
algorithm. 

After defining some terms, this section describes each of 
the algorithms used by the RF3570 to determine bus 
transfer width, then provides examples that illustrate the 
possible advantages inherent in each method. 

What is an The RF3570 can perform 8, 16, or 32 bit transfers of data 

Odd Byte? across the system bus. The choice of which bus width to 

use is based on the following three factors: 

• available system bus width 

• transfer count 

• memory address of the transfer 

The term "Odd Byte" is derived from the situation that 
occurs when an address and/ or transfer count cause the 
data transfer to either begin at an address not aligned to 
the full system bus width, and/or finish at an address that 
is not aligned to such a boundary. 
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In such cases there are remainder or "odd" bytes that 
must be handled. These odd bytes can occur at the 
beginning of a transfer (because the address of a transfer 
is not bus-width aligned) and also at the end of a transfer 
(when a transfer count contains a non-aligned number of 
bytes). 

A key to understanding the information in this section is 
to know the definition of terms that are used throughout. 

Bus-width Aligned Address 

In a system with a 32-bit system bus, four bytes of data 
can be transferred at once across the system bus. An 
address that is bus-width aligned to a 32-bit system bus, 
then, would be an even multiple of 4. On a 16-bit system 
bus, two bytes can be transferred at once; bus-width 
aligned addresses would be an even multiple of 2. 

Non-aligned Number of Bytes (or Non-aligned Transfer Count) 

These terms are used to describe a transfer count that is 
not evenly divisible by the number of bytes in the system 
bus width. A non-aligned transfer count can cause the 
transfer to end at an address that is not bus-width 
aligned. For a 32-bit system bus, this term applies to 
values that are not a multiple of 4. On a 16-bit bus it 
applies to values that are not a multiple of 2. 

Non-aligned Data 

This term is used to describe the bytes that cause a 
transfer to be non-aligned. They are the remainder bytes 
at the end of a transfer of a non-aligned number of bytes, 
or the extra bytes of data that occur at the beginning of a 
transfer when an address is not bus-width aligned. 


E 


Other Definitions 
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Algorithms for 
Transfer Width 
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Both systems used by the RF3570 adapter to determine 
bus width for data transfer involve the three factors 
already mentioned: system bus width, transfer count, and 
memory address. The system bus width is a 
predetermined constant, but the transfer count and 
address can change with each command. 

Standard Algorithm 

The Standard algorithm only sets up the hardware once 
for the entire data transfer operation. The transfer width is 
detemined by performing logical operations on the 
transfer count and address of the transfer. With a 32-bit 
system bus width, these are the possible results: 

If the data is aligned to a 32-bit bus, the RF3570 sets up the 
hardware for 32-bit wide transfer. 


If the non-aligned data is a word, the RF3570 sets up the 
hardware for 16-bit wide transfer. 


If the non-aligned data is an odd number of bytes, the 
RF3570 sets up the hardware for 8-bit wide transfer. 

Advantages 

• There is little adapter overhead per operation because 
there is only one hardware setup required for the 
entire transfer and only one interrupt to service. 

• The adapter will achieve the greatest throughput with 
minimal overhead when the transfers and addresses 
are aligned to system bus width. 

Disadvantage 

• The adapter will require more frequent use of the 
system bus resource because it will be using less than 
the maximum bus width during transfers that have 
non-aligned data. 





Usage 



Odd Byte Handling Algorithm 

The Odd Byte Handling algorithm allows the RF3570 to 
perform multiple setups of the hardware for each transfer. 
The result of the logical operation performed on the 
transfer count and memory address determines what and 
how many setups are used. 

If the transfer turns out to be aligned with the system bus 
width, the adapter performs a single setup, as with the 
Standard algorithm. If the transfer is not so aligned, the 
adapter can perform up to three different setups for the 
transfer, depending on the situation. These are the 
possible setups that may be required on a 32-bit system 
bus: 


If the address is not bus-width aligned, the adapter will 
setup to transfer (in 8-bit mode or 16-bit mode) the 1 to 3 
bytes of initial non-aligned data. 


The next setup performed by the adapter will take advan- 
tage of the full system bus width This transfer will move 
all data that is aligned to the full bus width 


If the transfer count contained a non-aligned number of 
bytes, the next possible setup would be 8-bit or 16-bit to 
move the 1 to 3 remainder bytes of non-aligned data. 

Advantage 

• For transfers that have non-aligned data, the adapter 
will utilize the minimum amount of available bus 
resource; the adapter will transfer most of the data 
using the full system bus width. 


Disadvantage 

• A greater amount of overhead is incurred because up 
to three different setups may be required, and up to 
three different interrupts may need servicing. 
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E 


Examples 


Example 1: 
A Bus-width Aligned 
Transfer 


Example 2: Transfer 
using a Non-aligned 
Transfer Count 


Usage 


The five examples that follow further illustrate the 
differences, advantages, and disadvantages of the Odd 
Byte Handling and Standard algorithms. 


Bus Width = 32 bit 
Address = 0000 
Transfer Count = 12 


This is the perfect scenario; the address is aligned to the 
system bus width, and the transfer count is evenly 
divisible by the number of bytes in same: 

12*4 = 3 

How would each algorithm handle a transfer that is 
perfectly aligned? 

Standard Algorithm 

The RF3570 performs a single hardware setup for three 
double-word transfers. 

Odd-Byte Handling Algorithm 

The RF3570 performs a single hardware setup for three 
double-word transfers. 

Conclusion 

For transfers that are entirely aligned, there is no 
difference in how each algorithm handles the transfer. 


Bus Width = 32 bit 
Address = 0000 
Transfer Count = 13 


This example illustrates a non-aligned transfer. The 
address of this transfer is bus-width aligned, but the 
transfer count contains a non-aligned number of bytes: 

13 * 4 = 3, with a remainder of 1. 


Rimfire 3570 User’s Guide 
7-20 





Usage 



How will each algorithm handle the non-aligned data 
resulting from a non-aligned number of bytes in the 
transfer count? 


Standard Algorithm 

The RF3570 sets up the hardware to perform 13 transfers 
of one byte each. 


Odd Byte Handling Algorithm 

The RF3570 performs the following set-ups: 

1 . Hardware is setup for 3 double-word transfers. 

2. Hardware is setup for 1 byte transfer. 


Conclusion 

The Standard Algorithm uses less overhead because it sets 
the hardware once for the entire operation, but it uses 
more of the bus resource by doing only byte-wide 
transfers. The Odd Byte Handling Algorithm spends more 
overhead (in hardware set-up) but transfers data more 
efficiently. 


Bus Width = 32 bit 
Address = 0001 
Transfer Count = 12 


Example 3: Transfer 
using a Byte-aligned 
Address 


This is a non-aligned transfer. The system bus is 32-bit, 
but the address in this example is aligned to a byte 
boundary. The transfer count however, is evenly divisible 
by the bytes in the system bus width: 

12 + 4=3 

How will each algorithm handle the non-aligned data 
resulting from an address that is not aligned to the 
bus-width? 
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Standard Algorithm 

The RF3570 performs a single hardware setup for 12 
transfers of one byte each. 

Odd Byte Handling Algorithm 

The RF3570 performs the following setups: 

1 . Hardware is set for 3 byte-wide transfers. When complete, 
the address is equal to 4 and the transfer count remaining 
is equal to 9. 

2. Hardware is set for 2 doubleword-wide transfers. When 
complete, the address is equal to 12 and the transfer count 
remaining is equal to 1. 

3. Hardware is set for 1 byte-wide transfer. 

Conclusion 

Again, the Standard Algorithm uses little overhead but 
more bus resource. The Odd Byte Handling Algorithm 
used 3 separate setups in this example and so involves 
more overhead. 


Example 4: Transfer 
using a Word-aligned 
Address 


Bus Width = 32 bit 
Address = 0002 
Transfer Count = 12 


This is another example of a non-aligned transfer. In this 
example, the address is aligned on a word boundary on a 
system with a 32 bit bus. However the transfer count is 
divisible by the number of bytes in the system bus width. 

12*4 = 3 

How will each algorithm handle the non-aligned data that 
results from using a word aligned address instead of a 
double-word aligned address? 
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Standard Algorithm 

The KF3570 performs a single hardware setup for 6 
word-wide transfers. 


Odd Byte Handling Algorithm 

The RF3570 performs the following setups: 

1 . Hardware is set for 1 word- wide transfer. When complete, 
the address is equal to 4 and the transfer count remaining 
is equal to 10. 

2. Hardware is set for 2 doubleword-wide transfers. When 
complete, the address is equal to 12 and the transfer count 
remaining is equal to 2. 

3. Hardware is set for 1 word-wide transfer. 


Conclusion 

The Standard Algorithm is somewhat more effective 
because it is able to use word-wide transfers. The Odd 
Byte Handling Algorithm again uses 3 separate setups 
which incurs overhead, but it was able to transfer the 
majority of data using the full bus width. 


Bus Width = 32 bit 
Address = 0003 
Transfer Count = 13 


Example 5: 
Non-aligned Transfer 
Count and Address 


This example of a non-aligned transfer illustrates what 
can happen when both the address and the transfer count 
are not aligned. The address is aligned to an odd byte. 
The transfer count is not divisible by the number of bytes 
in the system bus: 

13 -s- 4 = 3, with a remainder of 1 

How will each algorithm handle any non-aligned data 
that results from this combination of factors? 
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Standard Algorithm 

The RF3570 performs a single setup for transfer of 13 
bytes. 

Odd Byte Handling Algorithm 

The RF3570 performs the following setups: 

1 . Hardware is set for 1 byte-wide transfer. When complete, 
the address is equal to 4 and the transfer count remaining 
is equal to 12. 

2. Hardware is set for 3 doubleword-wide transfers. 

Conclusion 

Although the Standard Algorithm still takes less overhead 
and more bus resource, in this example the Odd Byte 
Handling Algorithm takes less overhead than previous 
examples by needing only two setups, and it still uses the 
bus efficiently. 
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There are several major factors that should influence the 
decision you make about which transfer width algorithm 
to use: 


• whether the majority of transfers are bus-width 
aligned 

• the size of a typical transfer 

• bus availability 

The first consideration is always bus-width alignment. If 
your transfers are mostly aligned, the Standard Algorithm 
is the best to use. If bus-width aligned transfers are not 
clearly in a majority, then you must look at the typical size 
of your transfers balanced with available bus resource. If 
your transfers tend to be small, the Odd Byte Handling 
Algorithm would incur greater overhead and degrade 
performance. If, on the other hand, you have medium to 
large transfers, the Odd Byte Handling Algorithm would 
provide better performance. Anytime that bus resource is 
at a premium, the Odd Byte Handling Algorithm is 
useful. A tradeoff exists between the two algorithms: 
better performance using the full bus width, versus better 
performance with reduced overhead. 


E 


Deciding on an 
Algorithm 
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Tagged Queuing 


How to Use Tagged 
Queuing 


NOTE: 


Usage 


The SCSI-2 specification provides a protocol for queuing 
commands at the device level. The device is responsible 
for managing the order of the commands, basing the 
order on message information from the initiator; the tag 
message used by the initiator instructs the device where 
to place the command in its queue. The initiator also 
uniquely numbers each command to identify it. 

The RF3570 fully supports the tagged queuing protocol. 
This section describes the RF3570 implementation of 
tagged queuing and how to use it. 

The RF3570 implementation of this SCSI-2 option is very 
simple to use. These are the steps: 

1. Enable Tagged Queuing 

In order to use the SCSI-2 option of Tagged Queuing, you 
must be sure that it is enabled on both the adapter and 
SCSI device. 

A. Enabling on the RF3570 


For the RF3570, tagged queuing is enabled for use 
with a device by issuing a Unit Options or Extended 
Unit Options command with the TAG bit of the Unit 
Flags field set before you issue any commands you 
want to tag. The RF3570 will only send tagged mes- 
sages to a device if this flag has been set. This could 
be done during initialization. 

B. Enabling on a SCSI Device 


You may also need to enable tagged queuing on your 
SCSI device with a Page OAH Mode Select. See your 
vendor-supplied documentation for more informa- 
tion. The RF3570 will not send an error to the Host if 
your device rejects the queue tag message. 

If your SCSI-2 device is operating with tagged queuing, the 
Queue Full Count and Maximum Queuedfields of the 
Extended Board Statistics command (16H) will contain values. 
See Chapter 6. 
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2. Choose a tag message. 

There are three tag messages specified by the SCSI-2 
protocol. You need only set the appropriate TAG OPTS 
bits in the Flags-2 field of the Pass-through Parameter 
Block for the command you are issuing to the SCSI device. 


j 



mis ' »— 


m 

Mill 

mil 

lllilli 

Mill 

lllilli 

IMBU 


0 

0 

0 





Figure 7-10: Meaning of Flags-2 Field 


These are the three messages defined by the SCSI-2 
specification, their meaning, and the TAG OPTS bit 
assignments for the Flags-2 field of the RF3570 command: 


IlilliB 

lllilli! 



00 

SIMPLE QUEUE TAG MESSAGE: The command may 
be processed by the SCSI-2 device out of sequence for 
efficiency. Example: device may sort commands by 
logical block address. 

01 

ORDERED QUEUE TAG MESSAGE: The command 
must be executed by the SCSI-2 device in the order sent 
by the adapter ( in order with respect to other commands 
sent with the ORDERED QUEUE TAG Message). 

10 

HEAD OF QUEUE TAG MESSAGE: The command is 
executed by the SCSI-2 device before all other 
commands previously sent, including other Head of 
Queue Tag commands but excluding the command 
currently in process. 

11 

Reserved 


Table 7-1: Meaning of TAG OPTS Bits 


As you determine the types of tag messages you wish to 
use, you should be aware that there are rules of execution 
that your SCSI-2 device must follow for each tag message 
or combination of tag message commands. For example, 
determination of priority in the case of mixed tag 
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How It Works 


Notes on Usage 


Usage 


messages, which executes first — an ORDERED QUEUE 
TAG or a SIMPLE QUEUE TAG? This situation and 
others are detailed in your SCSI-2 specification. 

3. The RF3570 sends the tag message. 

The RF3570 decodes these two bits, assigns a tag number 
and then manages the protocol for sending the proper 
message for the command. 


This is how the RF3570 processes commands that use tag 
messages: 

1 . The tag message is sent after the identify message and 
before the SCSI command. 

2. The adapter sends the commands in the exact order 
received from the host. 

3. The queue tag number that is sent with the tag mes- 
sage is assigned by the adapter in ascending order 
beginning with 1, maximum of 255. When 255 is 
reached, the RF3570 starts over again with 1. 


The following provides additional detail about how 

tagged queuing works for the RF3570. 

Queue Tag Numbers 

• The RF3570 will never have duplicate queue tag 
numbers assigned at the same time to any single 
device. 

• The maximum number out to a device at one time will 
be 255. 

• If all 255 tag numbers have been assigned to 
commands, the RF3570 simply waits for previous 
commands to complete before sending any more 
tagged commands to that device. 
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Queue Full Status 

• If a device reports Queue Full status before it has 
received all possible 255 commands, the RF3570 sets 
an internal threshold flag, 

(MAXlMUM_COMM ANDS) equal to the number of 
commands out at the time of the Queue Full status. 

• The command that generated the Queue Full status 
will once more be sent out to the device when the 
number of commands out to the device drops below 
the threshold set in MAXIMUM_COMMANDS. (One 
or more disconnected commands complete). This cuts 
down on unnecessary SCSI bus activity. 

• Once below the MAXIMUM_C OMM ANDS threshold, 
additional commands will continue to be sent to the 
SCSI device until another Queue Full status is 
reported, at which time the 
MAXIMUM_COMMANDS threshold is set again. 

Message Reject 

• On the intitial command to a SCSI device for which 
tagged queuing has been enabled, the adapter verifies 
that the device accepted the queue tag message. 

• If the device rejects the queue tag message, the RF3570 
does not send further queue tag messages in order to 
avoid unnecessary SCSI bus activity. 

• In the case of a message reject of a tag message, no 
error is reported to the host. 


Tagged Queueing Statistics 

The Extended Board Statistics command (16H) returns 
two fields, per target, that may be useful in evaluating the 
performance of tagged queuing with a SCSI-2 device. The 
fields are: Queue Full Count and Maximum Queued. See 
Chapter 6 for details. 
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Appendix A — Error Codes 


When the RF3570 adapter encounters a command or introduction 

operation error, it will return a value in the Error byte of 

the Status Block. This value can be used to determine the 

nature of the problem the adapter encountered. A list of 

these error codes is included in this appendix along with 

the error codes returned by Self-test. 

This appendix provides information on the following: Summary 

• Error Codes returned in the Error field of the Status 
Block. 

• Error Codes returned in the Status Port as a result of 
Self-test. 

This appendix is helpful for someone writing a driver for 
use with the RF3570. 
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Status Block The Error Codes on the following pages are the codes that 

Error Codes y° u will see returned in the Error field of the Status Block. 

The Status Block has this basic format: 


Address 
; Offset 

Address . • §§§§§ 


IgMMMMI 



III1MII 

Command Identifier | 

— 

Reserved 

SCSI Status 


Flags 

mm 

SCSI Sense Bytes 

BOH 

Figure A-1 : Base Status Block 


The Error Codes are meant to give you an indication of 
the conditions surrounding an adapter-detected error. 
There are two types of errors that can occur: system 
operation errors and SCSI bus errors. Both types of codes 
are fully described in order to assist you in determining 
the reason for a failure. 

hexadecimal values that do not appear in the current list 
of Error Codes are reserved by Ciprico for future use. 

Codes Reported in Status Block and Status Port 

Codes in the following list that are asterisked (* XXH) are 
considered catastrophic errors that will also be reported 
through the Status Port. 
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Code 

01H 


02H 


OFH 


* 11H 



Name Description 

Invalid Command This code will be reported for the following conditions: 

I In a Board-control Parameter Block: code used in the 
Command field is not a valid Board-control command. 
Occurs when Target/ Adapter ID field is equal to FFH 
(indicating a Board-control command). 

In a Pass-through Parameter Block: An invalid tag type 
was specified in the Flags-2 field. 

In a Scatter/Gather operation: The initial descriptor list of a 
Scatter/Gather command had no valid entries. 

In a Message Pass-through Parameter Block: A 
non-supported message was specified for a SCSI operation. 


Bad Unit Number 


This code will be reported for the following conditions: 
Target/Adapter ID field: The value specified in the 
Target/ Adapter ID field of a Parameter Block was not valid 
(valid values are 0-7 and FFH). 

In a Pass-through Parameter Block: The value specified in 
the Target ID field is the same as the SCSI ID assigned to 
the RF3570. This is not a valid SCSI ID to issue commands 
to. 

In a Pass-through Parameter Block: the value used in the 
LUN field of the SCSI command contained in the Parameter 
Block is invalid. (Valid values are 0-7.) 

In General Options Parameter Block: the value specified in 
the SCSI Bus ID field (used to designate an RF3570 SCSI ID 
other than that set with jumpers) is invalid. (V alid values 
are 0-7.) 

In Unit Options or Extended Unit Options Parameter 
Block: Value specified in the Unit SCSI ID field was invalid. 
(Valid values are any number between 0 and 7, not being 
used by the RF3570.) 


Bad Command List This code will be reported when the Start Command List 
Size command terminates for the following reasons: 

• Number of Parameter Blocks field contains invalid value. 
(V alid values are 2-2034.) 

• Number of Status Blocks field contains invalid value. 
(Valid values are 2 -4096.) 


State wrong for 
Start/Stop Command 
List command 


This code is returned under these conditions: 

Start Command List command issued when a command 
list is already active. 

Stop Command List command issued when no command 
list is presently active. 

Command List Channel Attention issued when no 
Command List is active. 


# 
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* 14H 

General Firmware 
Timeout 

The adapter times each of its transfers; it will report this 
error if a VMEbus or SCSI bus transfer takes too long to 
complete. On the VMEbus, this error can occur for transfers 
of parameters as well as transfers of data. 

* 15H 

VMEbus Error 
Occurred 

A VMEbus error was detected while the adapter was 
transferring either parameters or data. 

1EH 

SCSI Select Timeout 

For SCSI Pass-through operations, this code is reported 
when no SCSI device responds to the selection sequence 
within the timeout period. The timeout period is specified 
in die Unit Options command or Extended Unit Options 
command. 

1FH 

SCSI Disconnect 
Timeout 

For SCSI Pass-through commands, this code is reported 
when a disconnected SCSI device does not reselect the 
adapter within the timeout period. The timeout period is 
specified in the Unit Options command or Extended Unit 
Options command. 

20H 

SCSI Parity Error 

For SCSI Pass-through operations, this code is reported for 
any SCSI information transfer (message, command, data or 
status) that results in a parity error. 

21H 

Unexpected 

Disconnect 

If a SCSI device unexpectedly goes to the bus free state, this 
code will be reported. 

23H 

Unit Returned Bad 
SCSI Status 

If the device returns a bad status (status other than 0) in 
response to a SCSI Pass-through command, this code will 
be reported. The SCSI Status field of the Status Block will 
contain the Status Byte returned by the device (Busy, 
Reservation Conflict, Check Condition, etc.). 



If the SCSI status is Check Condition, and the automatic 
request sense feature of the adapter is not inhibited, the 
Selected Sense Bytes fields of the Status Block will contain 
the Status Bytes returned by the device. These will further 
describe the Check Condition. 



If the automatic Request Sense feature is inhibited (with the 
IRS bit of the Flags-1 byte), the Selected Sense Bytes fields of 
the Status Block will contain zeroes. 

24H 

Unexpected SCSI 
Phase Entered 

This code is reported if the SCSI device being accessed 
enters a phase that is unexpected for the command 
sequence issued. 
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25H 


Data Transfer 
Truncated 


If an automatic Request Sense command results in fewer 
bytes transferred than required to satisfy the Selected Sense 
Bytes fields of the' Status Block, this code will be reported. 
The Selected Sense Bytes fields of the Status Block that have 
been truncated will contain value FFH to aid the host in 
determining which Selected Sense Bytes are valid. 


27H 


SCSI Bus Reset 
Asserted or Detected 


This code can be reported for either of the following reasons: 

1. ) Certain conditions will arise that will force the adapter to 
assert RST on the SCSI bus in order to get to bus free. The 
SCSI command that was executing at the time of the RESET 
and any commands that were disconnected at the time of 
the RESET will report this error. A SCSI bus RESET is a 
last-resort measure that the adapter uses only if all prior 
error recovery attempts to get the SCSI bus to a free state 
have failed. 

2. ) The adapter detected a SCSI bus reset. The SCSI 
command currently executing and any commands that 
were disconnected at the time of the reset will report this 
code. 


31 H 


Message Queue Clear 
or Device Reset 
Occurred 


After executing a Message Pass-through operation of Bus 
Device Reset or Clear Queue, the adapter clears its internal 
queue of commands that were disconnected when the 
message was sent. This code will be reported in the Status 
Block of each disconnected command that was terminated 
due to the message-only operation. 


8EH Bad Task 


This error code indicates the occurence of an Internal 
Firmware error detected by the adapter. 


* 96H Internal Firmware 
Error 


This error code indicates that a Firmware error was 
detected during the execution of a command. 


A1H 


Invalid Unit Options 
Sense Count Value 


A value greater than 32 was placed in the Sense Count field 
of a Unit Options or Extended Unit Options command. 
Valid values for this field are 0 to 32. 
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Status Port In addition to the Error Codes that are reported in the 

Error Codes Status Block of the command, there is a group of codes 

that are used to report Self-test anomalies and also 
Catastrophic Error Conditions. These are reported in the 
Status Port. 


Catastrophic Error These are Error Codes that are returned in the Status Port 
Codes because conditions are such that it is unlikely that a Status 
Block could be read. The Status Port format at these times 
is as shown below: 


L _ 

■ 

14 13 12 11 ID 9 

•8 | 7 

111 

5; 

B 

111 

IB 

||! 



ERR 

D 

a 

RDY 

ENT 


Figure A-2: Status Port: General 


The Catastrophic Error Code field is highlighted above. 


The codes that can be returned in this field of the Status 
Port are described below: 


Go&WMM 


pDescnptkm i 

10H 

Bad PBIN Value 

The Command List PBIN (Parameter 
Block IN) value exceeded the value set 
for PBNUM (Parameter Block Number). 

11H 

State wrong for 
Start/Stop 
Command List 
command 

This code is returned under these 
conditions: 

Start Command List command issued 
when a command list is already active. 
Stop Command List command issued 
when no command list is presently 
active. 

Command List Channel Attention 
issued when no Command List is active. 

14H 

Software VMEbus 
Timeout 

The adapter times each of its VMEbus 1 
transfers; it will report this error if a j 

VMEbus transfer takes too long to 1 

complete. This can occur for transfers of I 
parameters as well as transfers of data. | 

15H 

VMEbus Error 
Occurred 

A VMEbus error was detected while the 
adapter was transferring either 
parameters or data. | 

96H 

Internal Firmware 
Error 

This error code indicates that a 
Firmware error was detected during the 1 
execution of a command. [ 


Table A-1 : Status Port Catastrophic Error Codes 
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Self-test occurs each time the RF3570 is powered on or Self-test Error Codes 

reset. If one of the Self-tests fail, an Error Code is reported 
in the Status Port. The format of the Status Port is as 
follows: 


ll BIT 1 

1 15 



i III 

12 

11 

ill 

ill 

IB 

bhhbbh 

HI 

0 

II 0 1 


RDY 

gjj 


n ■■ ■■!■■■ i Elm 

Figure A-3: Status Port: Reset 


The Self-test Code (STC) fields are highlighted in the 
illustration above. 


If one of the self-tests does not properly complete, its test 
number will be left in the Self-test Code fields. The table 
on the next page lists all the Self-test codes and describes 
the test performed. 

Note that bit 1 of the Status Port is not set until the board 
is in a Ready condition. Therefore, during Self-test it will 
remain zero. 

The Diagnostic/Self-test Board-control command allows Diagnostic/Self-test 
you to selectively perform the board Self-tests. In the Command 

event that one of the Self-tests does not complete 
properly, the Error Codes shown on the next page will be 
used to report the area of difficulty. 

It is important to note, however, that the codes are 
reported in the Error field of the Status Block returned 
from the Diagnostics/ Self-test command. In that case, 
these codes are returned in the Status Block Error field in 
addition to the normal Status Block Error Codes. 
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Error Codes 


mm 






The onboard processor is not working; it cannot access firmware EPROM; 
cannot access the Status Port - problem with Short Burst FIFO or 
VMEbus data lines. 


Static RAM error. All words of static RAM are written with FFFFH, then 
zero. This test is not exhaustive. 


Firmware checksum error. The calculated checksum for odd and even 
EPROMs does not match the value stored in EPROM. 


Short Burst FIFO cannot be accessed. SBF data could not be loaded or 
read back. 


Channel Attention Port cannot be accessed, or interrupt won't clear. 


PSI Address/Counter registers not masked to WORD boundaries. 


PSI Address/ Counter registers not masked to DWORD boundaries. 


Value Miscompare errors of PSI R/W registers in Manual Load mode. 


Value Miscompare errors of PSI R/W registers in Auto Load mode. 


SCSI termination power fuse is blown, but termination power is still 
present at the SCSI connector. 


SCSI termination power fuse is blown and termination power is not 
available at the connector. 


Value Miscompare error of Emulex Fast SCSI chip R/W registers. 


Emulex Fast SCSI chip did not generate a reset interrupt. 


Emulex Fast SCSI chip registers not zeroed after reset. 


SCSI bus hung, waiting for reset from Emulex Fast SCSI chip. Could be 
cabling. 


Short Burst FIFO 32 Bytes transfer miscompare error. 


Short Burst FIFO Local Ready of System Not Ready error. 


Short Burst FIFO byte transfer miscompare error. 


Short Burst FIFO Local Not Ready or System Ready error. 


The onboard processor failed the accumulator test. 


The onboard processor failed the store instruction test. 


The onboard processor failed the shift instruction test. 


The onboard processor failed the compare instruction test. 


The onboard processor failed the jump instruction test. 


Table A-2: Self-test Status Port Error Codes 
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Appendix B — Cables and Connectors 

The SCSI specification allows devices to operate with Introduction 

either a single-ended or a differential SCSI interface. The 
difference between interfaces is the manner in which SCSI 
signals are driven on the cable. 

The differential interface uses two lines for each signal 
(+SIGNAL and -SIGNAL). A signal is true when 
+SIGNAL is more positive than -SIGNAL. This interface 
provides better noise immunity than the single-ended 
interface and so allows a longer cable length to be used. 

The single-ended interface uses one line for each SCSI 
signal. 

All devices on a single SCSI bus must operate with the 
same interface. 

The RF3570 is available with either a single-ended or 
differential interface, with either low density ribbon cable 
connectors, or high density shielded connectors. 

This appendix provides the following information: Summary 

• Pin-outs of the differential connectors used for the 
RF3570 adapter. 

• Pin-outs of the single-ended connectors used for the 
RF3570 adapter. 

• Cable Lengths allowed for each interface. 

This appendix is most useful for those integrating devices 
on a SCSI bus. 
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Differential 

Connectors 


Maximum Cable 
Length 


Ribbon Cable 
Connector 


Shield Ground 


+DB (0) 


+DB (1) 


+DB (2) 


+DB (3) 


Cables and Connectors 


There are two models of RF3570 that support the 
differential SCSI interface. One is available with a ribbon 
cable connector and the other uses a high-density shielded 
connector. 

Maximum cable length for differential operation is 25 
meters (or 82 feet). This length includes internal cabling 
and cable stubs. 

The RF3574 model supports the differential SCSI interface 
with a ribbon cable connector. Its connector pin-outs are 
as follows: 


ilPiiiiipiH 



| Signal Name 


Ground 


-DB (0) 


■DB (1) 


-DB (2) 


-DB (3) 


+DB (4) 

11 

12 

-DB (4) 

+DB (5) 

13 

14 

-DB (5) 

+DB (6) 

15 

16 

-DB (6) 

+DB (7) 

17 

18 

-DB (7) 

+DB (P) 

19 

20 

-DB (P) 

Diffsens 

21 

22 

Ground 

Ground 

23 

24 

Ground 

Termpwr 

25 

26 

Termpwr 

Ground 

27 

28 

Ground 

+ATN 

29 

30 

-ATN 

Ground 

31 

32 

Ground 

+BSY 

33 

34 

-BSY 

+ACK 

35 

36 

-ACK 

+RST 

37 

38 

-RST 

+MSG 

39 

40 

-MSG 

+SEL 

41 

42 

-SEL 

+C/D 

43 

44 

-C/D 

+REQ 

45 

46 

-REQ 

+1/0 

47 

48 

-I/O 

Ground 

49 

50 

Ground 


Table B-1: Cable Connector Pin-outs for the RF3574 
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Cables and Connectors 



The RF3576 supports the differential SCSI interface with a High-Density 
high-density shielded connector. Its pin-outs are as Connector 

follows: 



Pin Number 

Signal Marne f§ 

Shield Ground 

1 

26 

Ground 

+DB (0) 

2 

27 

-DB (0) 

+DB (1) 

3 

28 

•DB (1) i 

+DB (2) 

4 

29 

-DB (2) 

+DB (3) 

5 

30 

-DB (3) 

+DB (4) 

6 

31 

-DB (4) 

+DB (5) 

7 

32 


+DB (6) 

8 

33 

| 

+DB (7) 

9 

34 

■DB (7) ! 

+DB (P) 

10 

35 

-DB (P) 

Diffsens 

11 

36 

Ground 

Ground 

12 

37 

Ground 

Termpwr 

13 

38 

Termpwr 

Ground 

14 

39 

Ground 

+ATN 

15 

40 

-ATN 

Ground 

16 

41 

Ground 

+BSY 

17 

42 

-BSY 

+ACK 

18 

43 

-ACK 

+RST 

19 

44 

-RST 

+MSG 

20 

45 

-MSG 

+SEL 

21 

46 

-SEL 

+C/D 

22 

47 

-C/D 

+REQ 

23 

48 

-REQ 

+1/0 

24 

49 

-I/O 

| Ground 

25 

50 

Ground f 


Table B-2: Cable Connector Pin-outs for the RF3576 
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Cables and Connectors 


Single-ended 

Connectors 

There are two models of RF3570 that support the 
single-ended SCSI interface. One is available with a 
ribbon cable connector and the other uses a high-density 
shielded connector. 

Maximum Cable 
Length 

Maximum cable length for single-ended operation is 6 
meters (or 20 feet). This length includes internal cabling 
and cable stubs. 

Ribbon Cable 
Connector 

The RF3573 model supports the single-ended SCSI 
interface with a ribbon cable connector. Its connector 
pin-outs are as follows: 



Table B-3: Cable Connector Pin-outs for the RF3573 
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Cables and Connectors 


B 


The RF3575 supports the single-ended SCSI interface with High-Density 
a high-density shielded connector. Its pin-outs are as Connector 

follows: 



Pin Number 

1 1 Signal Name 

Ground 

1 

26 

-DB (0) 

Ground 

2 

27 

"DB (1) 

Ground 

3 

28 

-DB (2) 

Ground 

4 

29 

-DB (3) 

Ground 

5 

30 

-DB (4) 

Ground 

6 

31 

-DB (5) 

Ground 

7 

32 

-DB (6) 

Ground 

8 

33 

-DB (7) 

Ground 

9 

34 

-DB (P) 

Ground 

10 

35 

Ground 

Ground 

11 

36 

Ground 

Ground 

12 

37 

Ground 

Open 

13 

38 

Termpwr 

Ground 

14 

39 

Ground 

Ground 

15 

40 

Ground 

Ground 

16 

41 

-ATN 

Ground 

17 

42 

Ground 

Ground 

18 

43 

-BSY 

Ground 

19 

44 

-ACK 

Ground 

20 

45 

-RST 

Ground 

H 

21 

46 

-MSG 

I Ground 

22 

47 

-SEL 

Ground 

23 

48 

-C/D 

Ground 

24 

49 

-REQ 

Ground 

25 

50 

-I/O 


Table B-4: Cable Connector Pin-outs for the RF3575 
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Appendix C — Specifications 


The RF3570 is designed to meet certain criteria: physical. Introduction 

electrical, environmental. The specifications are listed on 
the following page. 


This appendix lists the pertinent specifications for the Su ITHTiary 

RF3570 SCSI-Host bus adapter. 

This appendix is most helpful for someone choosing 
hardware for a system. 
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Specifications 


Specifications 


Physical 

Single slot, double height VME Eurocard form 
factor board: 

Dimensions: 233 mm by 160 mm 

Electrical 

Voltage: 4.75 Vdc to 5.25 Vdc 

Current: 4.0 Amps typical (at +5 Vdc) 

Capacity 

Up to seven SCSI devices 

Transfer Rate 

SCSI data rate to 7 Mbytes per second in 
Asynchronous mode. 

SCSI data rate to 10 Mbytes per second in 
Synchronous mode. 

Environmental 


Operating 

Temperature: 0° to +55° C 

Air Flow: 200 linear feet per minute 

Humidity: 10% to 80% (non-condensing) 

Elevation: 0 feet to 10,000 feet 

Non-Operating 

Temperature: - 40° to + 85° C 

Humidity: 10% to 95% (non-condensing) 

Elevation: 40,000 feet maximum 

Bus Interface 

VMEbus Standard (Revision C.l) 

Device Interface 

Draft Proposed American National Standard: 
Small Computer Systems Interface-2, (ANSI 
X3.131 - 199X 

Table C-1 : Specifications for the RF3570 
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Appendix D — Defaults 


Each Rimfire 3570 is shipped with the same factory Introduction 

settings. If you change nothing when you receive your 
board, it will power-up with the defaults that are listed in 
this appendix. 

This appendix provides information on the following: Su mmary 

• Hardware defaults as shipped from the factory. 

• Firmware defined defaults for these Board-control 
commands: Identify, General Options, Unit Options 
and Extended Unit Options, and Board Information. 

This appendix is helpful when you wish to know the 
values tiie RF3570 will assume if you do not change an 
option. 
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Defaults 

Hardware Defaults 

This section describes the defaults you will find for both 
the jumpers on the board, and the Hardware Ports you 
will use to set-up the board and operate it. 

Board Jumpers 

These are the factory settings for the jumpers on the 
board. For more information see Chapter 3. 


j um per 


VMEbus Address 
Modifier 

No jumper at AM2 

2D, Short Supervisory 
Access. 

VMEbus Address 

Jumper at A12 

EE00H 

SCSI Configuration Jumper Block: 

Parity Checking 

OUT 

Enabled 

SCSI Bus Reset at 
Power-up 

OUT 

Enabled 

RF3570 SCSI ID 

OUT 

ID = 0 

Bus Request/Grant 
Level 

6 jumpers installed: 
pins 4-5 under 0 
pins 4-5 under 1 
pins 4-5 under 2 
pins 1-2, 3-4, 5-6 
under 3 

Level 3 

Sysfail 

IN 

Sysfail signal asserted 
on bus during Reset. 

Exact Burst 

OUT 

Initiate VMEbus 
DMA operation as 
soon as data ready to 
transfer. 

SCSI Bus Terminators 

IN 

RF3570 provides SCSI 
Bus Termination. 


Table D-1: Hardware Defaults - Jumpers 
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Default 

Address Buffer Port: 

Byte Swapping Control 

0 

Word Swapping Control 

0 

Width 

1 

Byte Swapping Data 

0 

Word Swapping Data 

0 


The adapter will operate 
in 32-bit mode with 
Motorola ordering of 
bytes and words during 
data transfers; the 
parameter and status 
block structures will not 
be swapped. 


Initial value. 


After Reset has 
completed. 


Whenever ERR bit is 
zero, this should be 02H. 


There is no default: Write a 1 to initiate a 
Command List, write a 0 to issue a Single 
Command. 
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Defaults 


Command Defaults 


If you do nothing to change the board operation by using 
the available Board-control commands, the adapter uses 
defaults. These are listed below. For more information see 
Chapter 6. 



11— HI 

Meaning 

Identify - returned in the status block: | 

Engineering Revision 

XX 

| 

Firmware Revision 

XX 

Depends on revison. 

Day, Month, Year 

xxxxxx 

| 

1 Option Flags = 14H | 

I 

Tag 

bit 2=1 

Tagged commands 
supported. 

i 

Reset 

bit 4=1 

SCSI bus will reset at 
adapter reset - set by board 
jumper default setting. 

i 

SCSI ID 

bits 5, 6, 7 = 0 

Set by board jumper default 
settings. 

FW # of Even Prom 

XXXXXXXX 

Depends on revision. 

General Options - these are used if you set nothing yourself | 

| Bus Throttle 

20H 

Transfer Count throttle of 32. j 

Select Flags = 03H f 

1 

Disconnect/Reconnect 

bit 0 = 1 

Allow 

Disconnect/Reconnect. 

i 

SCSI Bus Parity 

bit 1 = 1 

Check for SCSI parity errors. 

1 

Block Mode Transfers 

bit 2 = 0 

Data transfers will not be 
block mode. 

i 

Odd Byte Handling 

bit 3 = 0 

Use Standard algorithm. 

Unit Options and Extended Unit Option 

S - used if you set nothing: 

Disconnect Timeout 

OH 

No timeout occurs. 

Retry Limit 

OH 

No retries enabled. 

1 1 Retry Control = OH 


Issue Interrupt 

bit 0 = 0 

No interrupt on retry. 


Issue Status Block 

bit 1 = 0 

No Status Block on retry. 


Retry Parity Errors 

bit 2 = 0 

No retry for parity errors. 


Retry Command Errors 

bit 3 = 0 

No retry for device errors. 


Retry Bus Errors 

o 

II 

rQ 

No retry for bus errors. j 

Table D-3: Command Defaults 
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Defaults 


E 


Command Parameters Default Values 


Unit Options and Extended Unit Options (cont): 


Select Timeout 


Unit Flags = OH 


Untagged Queue 


Synch Negotiation 


Inhibit ATN Signal 


Tagged Commands 


Sense Count 


Selected Sense Bytes 


I 

I 

I 


bit 0 = 0 


bit 1 = 0 


bit 2 = 0 


bit 6 = 0 


08H 


all = 0 


Meaning;! 


250 milliseconds. 


Send one command at a time. 


Will not initiate synchronous 
negotiation 


ATN will be asserted. 


Tagged commands not 
negotiated. 



Board Information - these are returned in a Data Structure 


Select Flags = 03H 



Disconnect/Reconnect 

bit 0 = 1 

Allow Disconnect/ Reconnect. 


SCSI Bus Parity 

bit 1 = 1 

Check for SCSI parity errors. 

1 

Block Mode Transfers 

bit 2 = 0 

Data transfer will not be block 
mode. 

□ 

Odd Byte Handling 

bit 3 = 0 

Use Standard algorithm. 

| Bus throttle 

20H 

Transfer count throttle of 32. 

Engineering Revision 

XX 

Depends on revision. 

Firmware Revision 

XX 

Day, Month, Year 

XXXXXX 



Option Flags = 14H 


TAG 

bit 2 = 1 

Tagged commands supported. 

Reset 

Bit 4 = 1 

SCSI bus will reset at adapter 
reset - set by board jumper 
default setting. 

SCSI ID 

bits 5, 6, 7 = 0 

Set by board jumper default 
settings. 

FW # of Even Prom 

XXXXXXXX 

Depends on revision. 

Tennination = OH | 

| Bad SCSI Term Power 

bit 1 = 0 

TERM PWR is good. | 

1 Blown SCSI Fuse 

bit 2 = 0 

Fuse is good. 1 


Table D-3: Command Defaults (continued) 
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D 


Defaults 


Command Parameters 

Default Values 1 


Board Information (cont): 

Jumper Configuration 

OH 

All Jumpers removed. 

Target - Disconnect 
Timeout 

OH 

No timeout occurs. 

Target - Retry Limit 

OH 

No retries occur. 

Target - Sense Count 

08H 

— 

First eight bytes of Sense Data. 

| Target - Device Flags = 0 J 

J 

Untagged Queueing 

o 

II 

o 

43 

Allow 1 Command at a time. 

1 

Synch Negotiation 

bit 1 = 0 

Synchronous negotiation not 1 
initiated. 


Inhibit ATN Signal 

o 

II 

CM 

# 

43 

ATN will be asserted. 


SCSI-2 

bit 6 = 0 

Target is not SCSI-2 device. 


Issue Interrupt 

o 

II 

00 

43 

No interrupt for retry. 


Issue Status Block 

bit 9 = 0 

No Status Block per retry. 


Retry Parity Errors 

bit 10 = 0 

No retry for Parity Errors. 


Retry Command Errors 

bit 11 = 0 

No retry for command errors. 


Retry Bus Errors 

bit 12 = 0 

No retry for bus errors. 

1 

Selected Sense 

bit 14 = 0 

First 8 bytes of sense data 
returned. 

Target - Synch Period 

t 1FH 

Equates to 125 nanoseconds. 

Target - Synch Offset 

tt OFH 

Emulex chip limit. 

Target - Selected Sense 
Bytes 

all = 0 

First eight bytes of Sense Data 
returned. 

t This value is returned when Synchronous transfer rate is 8 MB/ sec. 
tt This value is returned if the full Emulex FIFO is in use. 

Both values are zero if operation is in Asynchronous mode. 



Table D-3: Command Defaults (continued) 
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A 

Address Buffer Port 
address fields, 2-11 
address modifier field, 2-9 
control field, 2-9 
use of, 2-8 
Address Modifier 
choosing, 2-5 

use and location of jumper, 3-11 

B 

Block Diagram, 2-4 

BMT (Block Mode Transfer) bit, 6-21, 6-39 
Board Information (15H), 6-36 
data structure, 6-38 
Board Statistics (06H), 6-14 
data structure, 6-16 
Board-control Commands, 6-1 
a list of available commands, 6-5 
board information, 6-36 
board statistics, 6-14 
defaults, D-4 
diagnostic/self-test, 6-30 
error, 6-4 

extended board statistics, 6-48 
extended unit options, 6-52 
format of general status block, 6-3 
general options, 6-18 
identify, 6-10 
SCSI hard reset, 6-34 
start command list, 6-6 
stop command list, 6-8 
unit options, 6-22 
BSC (Byte Swapping Control) bit 
in control field of address buffer port, 2-9 
BSD (Byte Swap Data ) bit 
in control field of address buffer port, 2-10 
Bus Request/ Grant Jumper, 3-8 
Bus Throttle 
See Throttle 


Byte Swapping 

BSC (Byte Swapping Control) bit, 2-9 
BSD (Byte Swap Data) bit, 2-10 
use of feature, 7-2 

c 

Cabling, 3-19 
lengths, B-l 
Catastrophic Errors 
LEDs and, 3-17 

CC (Command Complete) bit, 4-7, 5-17, 6-4 
Channel Attention Port 
format of, 2-13 
use of for command list, 2-12 
use of for single command, 2-12 
CLRbit 

in extended board statistics, 6-49 
in options field of board statistics, 6-15 
Command Identifier 
use of in parameter block, 4-4 
use of in status block, 4-6 
Command Interface 
description of, 2-3 
Command List Structure 
creating, 4-22 
format of, 4-20 

number of parameter blocks, 4-21 
number of status blocks, 4-22 
parameter block in index, 4-21 
parameter block out index, 4-21 
parameter block space, 4-22 
status block in index, 4-21 
status block out index, 4-21 
status block space, 4-22 
using, 4-23 

Command Operation, 4-1 
Connectors 
pin-outs, B-l 

CSB (Continued Status Block) bit, 4-7, 5-17 
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D 

DAT (Data Transfer) bit, 5-4 
use of with DIR and DBV bits, 5-5 
DBV (Data Bits Valid) bit, 5-4 
use of with DIR and DAT bits, 5-5 
Defaults, D-l 
board jumpers, D-2 
command, D-4 
hardware ports, D-3 
Device Hags Field 

in board information command, 6-44 
Diagnostic/Self-test (09H), 6-30 
DIR (Direction of Data Transfer) bit, 5-3 
use of with DBV and DAT bits, 5-5 
DIS (Disconnect/Reconnect) bit, 6-20, 6-39 
Disconnect/Reconnect 
inhibiting with IAD bit, 5-13 
timeout, 6-23, 6-43, 6-54 
use of DIS bit, 6-20 

DTT (Data Transfer Truncated) bit, 4-7, 5-17 

E 

ERR (Error Status) bit, 4-7, 5-17, 6-4 
Error Codes, A-l 
01H, 5-15 
10H, 2-18, 3-17 
11H, 2-18, 3-17, 6-7, 6-9 
14H, 2-18, 3-17 
15H, 2-18, 3-17 
1FH, 6-23 
24H, 5-19 
96H, 2-18, 3-17 
reported in status block, A-2 
reported in status port - catastrophic, A-6 
reported in status port - selftest, A -7 
Error Field 

in pass-through status block, 5-18 
in status block, 4-8 
Exact Burst Jumper, 3-9 


Examples 

V routines for command list, 4-26 
memory differences, 7-2 
odd byte handling, 7-20 
scatter /gather operation, 7-14 
SCSI inquiry (single command), 4-17 
start command list (single command), 4-14 
Extended Board Statistics (16H), 6-48 
data structure, 6-50 
Extended Unit Options (18H), 6-52 
data structure, 6-54 

F 

Features, 1-2 
Hags Field 

in base status block, 4r7 
in identify command status block, 6-11 
in pass-through status block, 5-17 
Hags-1, 5-3 
Fuse, 3-13 

G 

General Options (07H), 6-18 

H 

Hardware Essentials, 2-1 
address buffer port, 2-8 
block diagram, 2-3 
board addressing, 2-5 
channel attention port, 2-12 
hardware ports, 2-6 
port usage, 2-19 
reset port, 2-19 
status port, 2-14 
Hardware Installation, 3-1 
board insertion, 3-14 
jumpers, 3-6 
LEDs, 3-16 
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overview, 3-2 
SCSI devices, 3-18 
termination, 3-12 
unpacking the board, 3-4 
Hardware Ports 
addresses, 2-6 
defaults, D-3 
overview, 2-7 
usage, 2-19 

/ 

IAD (Inhibit Automatic Disconnect) bit, 5-13 
IAT (Inhibit ATN Signal) bit, 6-26, 6-45, 6-58 
ICC (Inhibit Command Complete Interrupt) bit, 5-4 
Identify (05H), 6-10 

INT (Issue Interrupt) bit, 6-24, 6-45, 6-55 

Intel Ordering, 7-4 

Interrupts 

inhibiting with ICC bit, 5-4 
single command structure, 4-11 
use of INT bit for retries, 6-24, 6-55 
IRS (Inhibit Request Sense) bit, 5-4 
ISB (Issue Status Block) bit, 4-12, 6-24, 6-45, 6-56 

J 

JSM (Just Send Message) bit, 5-13 
Jumpers 

bus request/grant, 3-8 
defaults, D-2 
exact burst, 3-9 
factory set, 3-6 
SCSI configuration, 3-6 
sysfail, 3-9 

VMEbus address, 3-10 


L 

LEDs 

at power-up, 3-16 
indication of error, 3-17 
meaning of, 3-16 

M 

Motorola Ordering, 7-4 
Multiple Status Blocks, 4-8 
computing the number of blocks, 4-9 
CSB bit in flags field, 4-7 
retry generated, 4-9 
sense data generated, 4-9 
with selectable sense data, 5-22 
with sequential sense data, 5-21 

o 

OBH (Odd Byte Handling) bit, 6-21, 6-39 
Odd Byte Handling, 7-16 
enabling with OBH bit in general options, 6-21 
examples, 7-20 
Option Flags Field 

in identify command status block, 6-12 
Options Field 

in board statistics command, 6-15 
in extended board statistics, 6-49 
Options Flags Field 
in board information, 6-40 
Overview of RF3570, 1-1 
design, 1-2 
features, 1-2 
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PAR (Check SCSI Bus Parity) bit, 6-21, 6-39 
Parameter Block 
basic format of, 4-4 
command descriptor block, 4-5 
command identifier, 4-4 

command options, addresses, transfer count, 4-5 
explanation of, 4-4 
Pass-through Commands, 5-1 
Pass-through Message 
format, 5-15 
LUN, 5-15 
message code, 5-15 
Pass-through Parameter Block 
address modifier, 5-3 
command format, 5-2 
command identifier, 5-2 
flags-1, 5-3 
flags-2, 5-12 
message format, 5-15 
SCSI command descriptor block, 5-14 
target ID, 5-2 
transfer count, 5-14 
VME memory address, 5-14 
Pass-through Status Block 
command identifier, 5-16 
error field, 5-18 
flags, 5-17 
format, 5-16 
SCSI status, 5-18 
sense bytes, 5-20 
Pipelined System Interface (PSI) 
description of, 2-2 
PSI 

See Pipelined System Interface 


R 

RBE (Retry Bus Errors-SCSI) bit, 6-24, 6-46, 6-56 
RCE (Retry Command Errors) bit, 6-24, 6-46, 6-56 
Repair 

shipping damage, 3-4 
Request Sense 
default sense bytes, 5-20 
inhibiting with IRS bit, 5-4 
selectable sense bytes, 5-22 
sequential sense bytes, 5-21 
Reset Port 
description of, 2-19 
Retries 

determining retry limit set, 6-44 
retry control field, 6-24, 6-55 
retry limit field, 6-23, 6-55 
Return Procedures, iii 
shipment instructions, iv 
RMA Numbers, v 

RPE (Retry Parity Errors) bit, 6-24, 6-45, 6-56 
RST (Reset Jumper) bit, 6-41 
in identify command status block, 6-13 
RTY (Retry) bit, 4-7, 5-17 

s 

SBF 

See Short Burst FIFO 
Scatter/Gather 
example, 7-14 

format of descriptor block, 7-11 
notes on use, 7-13 

SGO (scatter /gather operation) bit, 5-3 
use of feature, 7-10 
SCSI Configuration Jumpers, 3-6 
default settings, 3-7 

reading with board information command, 6-43 
SCSI Hard Reset (10H), 6-34 
SCSI ID 

choosing for adapter, 6-19, 6-54 
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choosing for peripherals, 3-18 
reported for adapter, 6-13, 6-41 
SCSI Peripheral Options, 3-18 
SCSI Status 

during unexpected SCSI phase, 5-19 
SCSI Status Byte Code, 5-18 
SCSI Timeout, 6-25, 6-56 
Select Flags Field 
in board information, 6-38 
in general options, 6-20 
Select Timeout Field 
in extended unit options, 6-56 
in unit options, 6-25 
Self-test Codes, 2-15 
Sense Count 

determining as set per target, 6-44 
setting per target, 6-27, 6-58 
Sense Data 

specifying in extended unit options, 6-58 
specifying in unit options, 6-27 
Service Policy, iii 
SET (new control setting) bit 
in control field of address buffer port, 2-10 
SGO (Scatter/ Gather Operation) bit, 5-3 
Shipping Damage, 3-4 
Short Burst FIFO (SBF) 
description of, 2-2 
Single Command Structure 
examples of use, 4-14 
format of, 4-10 
interrupt/ID field, 4-11 
parameter block in, 4-10 
status block in, 4-12 
using, 4-13 
Specifications, C-l 
SS (Selected Sense) bit, 6-46 
Start Command List (01H), 6-6 
Status Block 
basic format of, 4-6 
command identifier, 4-6 


error field, 4-8 
explanation of, 4-6 
flags field, 4-7, 6-4 
for identify command, 6-11 
multiple, 4-8 
SCSI sense bytes, 4-8 
SCSI status field, 4-8 
Status Port 
errors reported, 2-18 
general format, 2-17 
reset format, 2-14 
Stop Command List (02H), 6-8 
SYN (Synchronous Negotiation) bit, 6-26, 6-44, 6-57 
Synchronous Negotiation 
determining synch period, offset negotiated, 6-46 
enabling, 6-26, 6-57 
Sysfail Jumper, 3-9 

T 

TAG (Tagged Queuing) bit, 6-12, 6-26, 6-41, 6-58 
TAG OPTS (Tag Options) bits, 5-12, 7-27 
Tagged Queuing 

enabling negotiation in extended unit options, 6-58 
enabling negotiation in unit options, 6-26 
how to use, 7-26 
notes on use, 7-28 
Termination 

determining if good using BTP and BSF bits, 6-42 
location of fuse, 3-13 
location of resistor packs, 3-12 
on SCSI peripheral, 3-19 
use of STT bit in diagnostics test, 6-32 
Test Hags Field 
in diagnostics/selftest, 6-31 
Throttle, 6-19 

byte or transfer throttle selection, 6-20 
throttle count, 6-19 

values reported in board information, 6-40 
TQE (Tagged Queuing Enabled) bit, 6-45 
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Unit Flags Field 
in extended unit options, 6-57 
in unit options, 6-25 
Unit Options (08H), 6-22 
UNQ (Untagged Queuing) bit, 6-25, 6-44, 6-57 
Untagged Queuing, 6-25 
Usage, 7-1 

byte and word swapping, 7-2 
odd byte handling, 7-16 
scatter/gather, 7-10 
tagged queuing, 7-26 

V 

VMEbus Address 
choosing, 2-6 

use and location of jumpers, 3-10 

w 

Warranty, i 

WID (Width of Data Transfers) bit 
in control field of address buffer port, 2-10 
Word Swapping 
use of feature, 7-2 

WSC (Word Swapping Control) bit, 2-10 
WSD (Word Swap Data) bit, 2-10 
WSC (Word Swapping Control) bit 
in control field of address buffer port, 2-10 
WSD (Word Swap Data) bit 
in control field of address buffer port, 2-10 
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CIPRICO 

2800 Campus Drive, Plymouth, MN 55441 
(612) 551-4000 


CIPRICO LISTENS. AND RESPONDS. 
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